Skip to content
Merged
Show file tree
Hide file tree
Changes from 21 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion apify-docs-theme/src/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -132,7 +132,7 @@ const themeConfig = {
href: 'https://github.com/apify',
},
{
label: 'Actor Whitepaper',
label: 'Actor whitepaper',
href: 'https://whitepaper.actor',
},
],
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
40 changes: 32 additions & 8 deletions sources/platform/actors/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -31,20 +31,44 @@ import CardGrid from "@site/src/components/CardGrid";
/>
</CardGrid>

## What is an Actor?
## Actors overview

Actors are serverless programs running in the cloud. They can perform anything from simple actions (such as filling out a web form or sending an email) to complex operations (such as crawling an entire website or removing duplicates from a large dataset). Actor runs can be as short or as long as necessary. They could last seconds, hours, or even infinitely.
Actors are serverless cloud programs that can perform anything from a simple action, like filling out a web form, to a complex operation, like crawling an entire website or removing duplicates from a large dataset. Because Actors can persist their state and be restarted, their runs can be as short or as long as necessary, from seconds to hours, or even indefinitely.

> **To get better idea of what Apify Actors are, visit [Apify Store](https://apify.com/store), and try out some of them!**
> ![Apify Store](./running/images/store-google-maps-scraper.png)
Basically, Actors are programs packaged as Docker images, which accept a well-defined JSON input, perform an action, and optionally produce a well-defined JSON output.

You can use Actors [manually in Apify Console](https://console.apify.com/actors), by using the [API](/api/v2) or [scheduler](../schedules.md). You can easily [integrate them with other apps](../integrations/index.mdx) and share your Actors with other Apify users via [Apify Store](https://apify.com/store) or [access rights](./collaboration/access-rights) system.
:::info Additional ontext

## Actors are containers
For more context, read [Actor whitepaper](https://whitepaper.actor/).

A single isolated Actor consists of source code and various settings. You can think of an Actor as a cloud app or service that runs on the Apify platform. The run of an Actor is not limited to the lifetime of a single HTTP transaction. It can run for as long as necessary, even forever.
:::

## 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](./images/apify-actor-drawing.png)

## Running Actors
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It makes sense to unify the style of heading to not use gerunds

Suggested change
## Running Actors
## Run Actors


You can run Actors manually in [Apify Console](https://console.apify.com/actors), using the [API](/api), [CLI](/cli), or [scheduler](../schedules.md). You can easily [integrate Actors](../integrations/index.mdx) with other apps, [share](../collaboration/access_rights.md) them with other people, [publish](./publishing/index.mdx) them in [Apify Store](https://apify.com/store), and even [monetize](./publishing/monetize.mdx).

:::tip Try Actors

To get a better idea of what Apify Actors are, visit [Apify Store](https://apify.com/store) and try out some of them!

![Apify Store](./running/images/store-google-maps-scraper.png)

:::

Basically, Actors are programs packaged as [Docker images](https://hub.docker.com/), which accept a well-defined JSON input, perform an action, and optionally produce an output.

## Public and private Actors

Expand Down
4 changes: 2 additions & 2 deletions sources/platform/storage/dataset.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,8 @@ Dataset storage enables you to sequentially save and retrieve data. A unique dat

Typically, datasets comprise results from web scraping, crawling, and data processing jobs. You can visualize this data in a table, where each object is forming a row and its attributes are represented as columns. You have the option to export data in various formats, including JSON, CSV, XML, Excel, HTML Table, RSS or JSONL.

> Named datasets are retained indefinitely. <br/>
> Unnamed datasets expire after 7 days unless otherwise specified. <br/> > [Learn more](/platform/storage/usage#named-and-unnamed-storages)
> Named datasets are retained indefinitely.
> Unnamed datasets expire after 7 days unless otherwise specified. [Learn more](/platform/storage/usage#named-and-unnamed-storages)
Dataset storage is _append-only_ - data can only be added and cannot be modified or deleted once stored.

Expand Down
Loading