Apify

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.

Use the block

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.

Actions

APIFY Run Actor (Sync)

Run an APIFY actor synchronously and get results (max 5 minutes)

Input

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"

Output

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)

APIFY Run Actor (Async)

Start an APIFY Actor run and poll it within the same workflow step until completion or the polling deadline

Input

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"

Output

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)

APIFY Run Task

Run a saved APIFY actor task synchronously and get dataset items (max 5 minutes)

Input

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"

Output

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

APIFY Get Dataset Items

Retrieve items stored in an APIFY dataset

Input

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"

Output

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

APIFY Get Run

Get the status and details of an APIFY actor run

Input

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"

Output

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)