Skip to main content

Actors

Actors are serverless cloud programs that take a structured JSON input, perform a task (web scraping, browser automation, data processing, and more), and optionally produce a structured output. Run them manually in Apify Console, through the API or CLI, or on a schedule, and combine them into larger automations.

Additional context

For more context, read the Actor whitepaper.

Actor lifecycle

Actor components

Actors consist of these elements:

  • Dockerfile which specifies where the Actor's source code is, how to build it, and run it.
  • Documentation in a form of a README.md file.
  • Input and output schemas that describe what input the Actor requires, and what results it produces.
  • Access to an out-of-the-box storage system for Actor data, results, and files.
  • Metadata such as the Actor name, description, author, and version.

The documentation and input/output schemas help people understand what the Actor does, enter required inputs in the user interface or API, and integrate results into other workflows. Actors can call and interact with each other to build more complex systems from simple ones.

Apify Actor diagram

Public and private Actors

Actors can be public or private. Private Actors are yours to use and keep; no one will see them if you don't want them to. Public Actors are available to everyone in Apify Store. You can make them free to use, or you can charge for them.