Apify runs Actors for web scraping and browser automation. Run an Actor synchronously when it can finish within the synchronous endpoint’s five-minute limit. Run Actor (Async) starts a provider run and polls it within the same Sim step; it does not return immediately for detached processing. Its polling budget follows Sim’s default synchronous execution timeout. If that wait ends before the Actor finishes, use the returned run ID with Get Run, then retrieve dataset items after success. You can also run saved Actor tasks and fetch dataset items directly.
Run any Apify actor or saved task with custom input, fetch dataset items, and check run status. Supports both synchronous and asynchronous execution with automatic dataset fetching.
Run an APIFY actor synchronously and get results (max 5 minutes)
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | APIFY API token from console.apify.com/account#/integrations |
actorId | string | Yes | Actor ID or username/actor-name. Examples: "apify/web-scraper", "janedoe/my-actor", "moJRLRc85AitArpNN" |
input | string | No | Actor input as JSON string. Example: { "startUrls": [ { "url": "https://example.com" } ], "maxPages": 10 } |
memory | number | No | Memory in megabytes allocated for the actor run (128-32768). Example: 1024 for 1GB, 2048 for 2GB |
timeout | number | No | Timeout in seconds for the actor run. Example: 300 for 5 minutes, 3600 for 1 hour |
build | string | No | Actor build to run. Examples: "latest", "beta", "1.2.3", "build-tag-name" |
| Parameter | Type | Description |
|---|
success | boolean | Whether the actor run succeeded |
runId | string | APIFY run ID |
status | string | Run status (SUCCEEDED, FAILED, etc.) |
items | array | Dataset items (if completed) |
Start an APIFY Actor run and poll it within the same workflow step until completion or the polling deadline
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | APIFY API token from console.apify.com/account#/integrations |
actorId | string | Yes | Actor ID or username/actor-name. Examples: "apify/web-scraper", "janedoe/my-actor", "moJRLRc85AitArpNN" |
input | string | No | Actor input as JSON string. Example: { "startUrls": [ { "url": "https://example.com" } ], "maxPages": 10 } |
waitForFinish | number | No | Initial wait time in seconds (0-60) before polling starts. Example: 30 |
itemLimit | number | No | Max dataset items to fetch (1-250000). Default: 100. Example: 500 |
memory | number | No | Memory in megabytes allocated for the actor run (128-32768). Example: 1024 for 1GB, 2048 for 2GB |
timeout | number | No | Timeout in seconds for the actor run. Example: 300 for 5 minutes, 3600 for 1 hour |
build | string | No | Actor build to run. Examples: "latest", "beta", "1.2.3", "build-tag-name" |
| Parameter | Type | Description |
|---|
success | boolean | Whether the actor run succeeded |
runId | string | APIFY run ID |
status | string | Run status (SUCCEEDED, FAILED, etc.) |
datasetId | string | Dataset ID containing results |
items | array | Dataset items (if completed) |
Run a saved APIFY actor task synchronously and get dataset items (max 5 minutes)
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | APIFY API token from console.apify.com/account#/integrations |
taskId | string | Yes | Task ID or username/task-name. Examples: "janedoe/my-task", "moJRLRc85AitArpNN" |
input | string | No | JSON string that overrides the task's saved input. Example: { "startUrls": [ { "url": "https://example.com" } ] } |
itemLimit | number | No | Max dataset items to return (1-250000). Example: 500 |
memory | number | No | Memory in megabytes allocated for the run (128-32768). Example: 1024 for 1GB |
timeout | number | No | Timeout in seconds for the run. Example: 300 for 5 minutes |
build | string | No | Actor build to run. Examples: "latest", "beta", "1.2.3" |
| Parameter | Type | Description |
|---|
success | boolean | Whether the task run succeeded |
status | string | Run status (SUCCEEDED, FAILED, etc.) |
items | array | Dataset items produced by the run |
Retrieve items stored in an APIFY dataset
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | APIFY API token from console.apify.com/account#/integrations |
datasetId | string | Yes | Dataset ID to read items from. Example: "9RnD3Pql2vGZkc5H5" |
itemLimit | number | No | Max items to return (1-250000). Default: all items. Example: 500 |
offset | number | No | Number of items to skip at the start. Default: 0 |
fields | string | No | Comma-separated list of fields to include. Example: "title,url,price" |
| Parameter | Type | Description |
|---|
success | boolean | Whether the items were retrieved |
datasetId | string | Dataset ID the items were read from |
items | array | Items stored in the dataset |
count | number | Number of items returned |
Get the status and details of an APIFY actor run
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | APIFY API token from console.apify.com/account#/integrations |
runId | string | Yes | Actor run ID to fetch. Example: "HG7ML7M8z78YcAPEB" |
| Parameter | Type | Description |
|---|
success | boolean | Whether the run was found |
runId | string | APIFY run ID |
status | string | Run status (READY, RUNNING, SUCCEEDED, FAILED, etc.) |
startedAt | string | When the run started (ISO timestamp) |
finishedAt | string | When the run finished (ISO timestamp) |
datasetId | string | Default dataset ID for the run |
keyValueStoreId | string | Default key-value store ID for the run |
stats | json | Run statistics (memory, CPU, duration) |
