Apify

Integrate Apify with your AI workspace

Apify is a platform for building, deploying, and managing web scraping and automation tools, known as Actors.

Explore Triggers and Actions

Abort Actor Build

Tool to abort an Actor build that is starting or running. Use when you need to cancel a build in progress. Builds in terminal states (FINISHED, FAILED, ABORTING, TIMED-OUT) are not affected.

ActionTry it

Abort Actor Run

Tool to abort a running or starting Actor run. Use when you need to stop an Actor run that is currently in STARTING or RUNNING status. For runs with status FINISHED, FAILED, ABORTING, and TIMED-OUT this call does nothing.

ActionTry it

Add Request to Queue

Tool to add a request to the queue. Use when you need to add a web page URL to a request queue for crawling. If a request with the same uniqueKey was already present in the queue, returns the ID of the existing request.

ActionTry it

Batch Add Requests to Queue

Tool to batch-add up to 25 requests to a request queue. Use when you need to add multiple requests efficiently. Failed requests due to rate limits should be retried with exponential backoff.

ActionTry it

Batch Delete Requests from Queue

Tool to batch-delete up to 25 requests from a queue. Use when you need to remove multiple requests efficiently. Failed requests due to rate limits should be retried with exponential backoff.

ActionTry it

Build Actor

Tool to build an Actor with specified configuration. Use when you need to create a new build of an Actor with a specific version. The build process compiles the Actor's source code into a Docker image.

ActionTry it

Check Key-Value Store Record Exists

Tool to check if a record exists in a key-value store. Use when you need to verify whether a specific key exists in an Apify Key-Value Store without retrieving its content.

ActionTry it

Create Actor

Tool to create a new Actor with specified configuration. Use when you need to initialize a fresh Actor programmatically before publishing or running it.

ActionTry it

Create Actor Task

Tool to create a new Actor task with specified settings. Use when you need to configure or schedule recurring Actor runs programmatically.

ActionTry it

Create Actor Version

Tool to create a new version of an Actor. Use when you need to add a new version with specific source code location and configuration. Requires versionNumber and sourceType parameters, plus conditional parameters based on the sourceType.

ActionTry it

Create Actor Version Environment Variable

Tool to create an environment variable for a specific Actor version. Use when adding new environment variables to Actor versions. Requires name and value parameters.

ActionTry it

Create Dataset

Tool to create a new dataset. Use when you need to initialize or retrieve a dataset by name.

ActionTry it

Create Key-Value Store

Tool to create a new key-value store or retrieve an existing one by name. Use when you need to initialize a store for saving data records or files. If a store with the given name already exists, returns that store instead of creating a duplicate.

ActionTry it

Create Request Queue

Tool to create a new request queue or retrieve an existing one by name. Use when you need to initialize a queue for storing and managing web scraping requests. If a queue with the given name already exists, returns that queue instead of creating a duplicate. Unnamed queues follow data retention period policies.

ActionTry it

Create Schedule

Tool to create a new schedule with specified settings. Use when you need to automate Actor or Actor task execution at specific times using cron expressions.

ActionTry it

Create Task Webhook

Tool to create a webhook for an Actor task. Use when you need external notifications about task run events (e.g., completion or failure) in downstream systems.

ActionTry it

Delete Actor

Tool to delete an Actor permanently. Use when you need to remove an Actor by its ID or username~actorName. Confirm before calling.

ActionTry it

Delete Actor Build

Tool to delete an Actor build permanently. Use when you need to remove a specific build by its ID. The default build for an Actor cannot be deleted. Only users with build permissions can delete builds.

ActionTry it

Delete Actor Run

Tool to delete a finished Actor run. Use when you need to permanently remove a completed run. Only finished runs can be deleted by the initiating user or organization.

ActionTry it

Delete Actor Task

Tool to delete an Actor task permanently. Use when you need to remove a task by its ID or username~taskName. Confirm before calling.

ActionTry it

Delete Actor Version

Tool to delete a specific version of an Actor's source code. Use when you need to remove an Actor version by actor ID and version number. Confirm before calling.

ActionTry it

Delete Actor Version Environment Variable

Tool to delete an environment variable from a specific Actor version. Use when removing environment variables from Actor versions.

ActionTry it

Delete Dataset

Tool to delete a dataset permanently. Use when you need to remove a dataset by its ID or username~dataset-name. Confirm before calling.

ActionTry it

Delete Key-Value Store

Tool to delete a key-value store permanently. Use when you need to remove a key-value store by its ID. Confirm before calling.

ActionTry it

Delete Key-Value Store Record

Tool to delete a record from a key-value store. Use when you need to remove a specific record by its key from an Apify Key-Value Store.

ActionTry it

Delete Request from Queue

Tool to delete a specific request from a request queue. Use when you need to remove a request by its ID from an Apify request queue.

ActionTry it

Delete Request Lock

Tool to delete a request lock from a request queue. Use when you need to unlock a previously locked request. Only the client that locked the request can delete its lock.

ActionTry it

Delete Request Queue

Tool to delete a request queue permanently. Use when you need to remove a request queue by its ID.

ActionTry it

Delete Schedule

Tool to delete a schedule by its ID. Use when you need to remove a schedule from the Apify system.

ActionTry it

Delete Webhook

Tool to delete a webhook by its ID. Use when removing a webhook after confirming the webhook ID.

ActionTry it

Get Account Limits

Tool to get a complete summary of account limits and usage. Use when you need to retrieve information about usage cycles, spending caps, compute resources, data transfer quotas, and other account limits. This shows the same information as the Limits page in Apify console.

ActionTry it

Get Actor Build

Tool to get detailed information about a specific Actor build. Use when you need to retrieve complete build details by build ID. Optionally wait for the build to finish using the waitForFinish parameter to avoid polling.

ActionTry it

Get Actor Build Log

Tool to retrieve the log file for a specific Actor build. Use when you need to inspect logs generated during an Actor build process. Only the trailing 5 million characters of the log are stored.

ActionTry it

Get Actor Details

Tool to get details of a specific Actor. Use when you need actor metadata by ID or username/actorName. Response includes `isDeprecated` and `notice` fields indicating deprecation status, and `pricingInfos` for per-unit cost details — review both before scheduling runs.

ActionTry it

Get Actor Last Run Dataset Items

Tool to get dataset items from the last run of an Actor. Use when you need to retrieve output data from the most recent Actor execution, optionally filtered by run status (e.g., status='SUCCEEDED' to get items only from the last successful run).

ActionTry it

Get Actor Run

Tool to get details about a specific Actor run. Use when you need to retrieve comprehensive information about a run including its execution status, resource usage, storage IDs, and metadata.

ActionTry it

Get Actor Task

Tool to get complete details about an Actor task. Use when you need to retrieve task configuration, input settings, or metadata by task ID or username~task-name.

ActionTry it

Get Actor version

Tool to get details about a specific version of an Actor. Use when you need version metadata including source type, build tag, and configuration details.

ActionTry it

Get Actor Version Environment Variable

Tool to get environment variable details for a specific Actor version. Use when retrieving environment variable information from an Actor version. Returns name, value (if not secret), and secret status.

ActionTry it

Get all webhooks

Tool to get a list of all webhooks created by the user. Use when you need to enumerate webhooks before filtering or maintenance.

ActionTry it

Get Current User Account Data

Tool to get private user account information. Use when you need to retrieve comprehensive data about the current user identified by the authentication token, including profile, subscription plan, and proxy settings. Note: 'plan', 'email', and 'profile' fields are omitted when accessed from Actor run.

ActionTry it

Get Dataset

Tool to retrieve dataset metadata by dataset ID. Use when you need information about a dataset's structure, item counts, or access URLs. This does not return dataset items themselves.

ActionTry it

Get dataset items

Tool to retrieve items from a dataset. Use when you need to fetch data from a specified dataset by pagination or filtering. Only JSON format is fully supported. For datasets larger than 1000 items, issue multiple calls incrementing `offset` by `limit` until the response returns fewer items than `limit`.

ActionTry it

Get Dataset Statistics

Tool to get dataset field statistics by dataset ID. Use when you need statistical information about dataset fields including min, max, null count, and empty count. Only provides field statistics when dataset schema is configured.

ActionTry it

Get Default Build

Tool to get the default build for an Actor. Use after specifying the Actor ID; optionally wait for the build to finish before returning.

ActionTry it

Get Head and Lock Queue Requests

Tool to get and lock head requests from the queue. Returns the given number of first requests from the queue and locks them for the given time, preventing other clients from accessing them during the lock period. Use when you need to process requests exclusively without concurrent access by other clients.

ActionTry it

Get Key-Value Record

Tool to retrieve a record from a key-value store. Use when you need to fetch a specific value by key from an Apify Key-Value Store.

ActionTry it

Get Key-Value Store

Tool to retrieve key-value store metadata by store ID. Use when you need detailed information about a specific key-value store including stats and access URLs.

ActionTry it

Get Key-Value Store Keys

Tool to retrieve a list of keys from a key-value store. Use when you need to list keys in a store with optional filtering and pagination support.

ActionTry it

Get last actor run

Tool to get the most recent run of a specific Actor. Use when you need to retrieve the last execution details of an Actor and optionally filter by status (e.g., status='SUCCEEDED' to get only the last successful run).

ActionTry it

Get last actor task run

Tool to get the most recent run of a specific Actor task. Use when you need to retrieve the last execution details. You can filter by status to get only successful runs using status='SUCCEEDED'.

ActionTry it

Get list of Actor version environment variables

Tool to get the list of environment variables for a specific Actor version. Use when you need to retrieve environment variable configurations for an Actor version.

ActionTry it

Get list of Actor versions

Tool to get the list of versions of a specific Actor. Use when you need to retrieve version metadata including source type, version number, and configuration details.

ActionTry it

Get list of Actor webhooks

Tool to get a list of webhooks for a specific Actor. Use when you need to review or manage webhooks configured for an Actor.

ActionTry it

Get list of Actors

Tool to get the list of all Actors that the user created or used. Use when you need to enumerate or browse Actors. Add my=1 to get only user-created Actors.

ActionTry it

Get list of Actors in Store

Tool to get list of public Actors from Apify Store. Use when you need to browse or search public Actors available in the store. Supports searching by title, name, description, username, and readme.

ActionTry it

Get list of builds

Tool to get a list of builds for a specific Actor. Use when you need paginated access to an Actor’s build (version) history.

ActionTry it

Get list of datasets

Tool to get list of datasets for a user. Use when you need to enumerate or browse user's datasets. Supports pagination with up to 1000 items per page.

ActionTry it

Get list of key-value stores

Tool to get the list of key-value stores owned by the user. Use when you need to enumerate or browse available stores. Supports pagination up to 1000 records per request.

ActionTry it

Get list of request queues

Tool to get list of request queues for a user. Use when you need to enumerate or browse user's request queues. Supports pagination with up to 1000 items per page.

ActionTry it

Get list of runs

Tool to get a list of runs for a specific Actor. Use when you need to paginate through runs and optionally filter by status before processing run data.

ActionTry it

Get list of schedules

Tool to get list of schedules created by the user. Use when you need to browse or enumerate user's schedules. Supports pagination with up to 1000 items per page.

ActionTry it

Get list of task runs

Tool to get a list of runs for a specific Actor task. Use when you need to paginate through task runs and optionally filter by status.

ActionTry it

Get list of task webhooks

Tool to get a list of webhooks for a specific Actor task. Use when you need to review or paginate webhooks after creating or updating a task.

ActionTry it

Get list of tasks

Tool to fetch a paginated list of tasks belonging to the authenticated user. Use when you need to browse or sort tasks created by the user.

ActionTry it

Get list of webhook dispatches

Tool to get list of webhook dispatches for the user. Use when you need to retrieve webhook execution history with pagination support.

ActionTry it

Get log

Tool to retrieve logs for a specific Actor run or build. Use after a run completes or fails — a run may report success status yet contain only informational messages, making log inspection the only way to confirm actual outcomes. For long runs, log responses can be very large; prioritize error-level entries and recent timestamps to diagnose issues efficiently.

ActionTry it

Get Monthly Usage

Tool to get monthly usage summary with daily breakdown. Use when you need detailed usage information including storage, data transfer, and request queue metrics for the current or a specific billing cycle. This shows the same information as the Billing page in Apify console.

ActionTry it

Get OpenAPI Definition

Tool to get the OpenAPI definition for a specific Actor build. Use when you need the API schema for code generation or analysis.

ActionTry it

Get Public User Data

Tool to get public user data. Use when you need to retrieve publicly accessible information about a specific Apify user account, similar to what can be seen on public profile pages. This operation requires no authentication token.

ActionTry it

Get Request from Queue

Tool to retrieve a specific request from a request queue by its ID. Use when you need to get detailed information about a request in an Apify request queue.

ActionTry it

Get Request Queue

Tool to retrieve request queue metadata by queue ID. Use when you need information about a specific request queue including its statistics and request counts.

ActionTry it

Get Request Queue Head

Tool to retrieve first requests from the queue for inspection. Use when you need to examine pending requests without locking them.

ActionTry it

Get Run Dataset Items

Tool to get dataset items from a specific Actor run. Use when you need to retrieve the output data from a completed or running Actor run.

ActionTry it

Get Schedule

Tool to get schedule details by ID. Use when you need to retrieve comprehensive information about a schedule including cron expression, timezone, actions, and execution times.

ActionTry it

Get Schedule Log

Tool to get schedule log by ID. Use when you need to retrieve execution history for a schedule, including invocation timestamps and status messages. Returns up to 1000 invocations.

ActionTry it

Get Task Input

Tool to retrieve the input configuration of a specific task. Use when you need to inspect stored task input before execution or debugging.

ActionTry it

Get Task Last Run Dataset Items

Tool to get dataset items from the last run of an Actor task. Use when you need to retrieve data from the most recent task execution. Filter by status (e.g., 'SUCCEEDED') to get items from the last successful run only.

ActionTry it

Get user builds list

Tool to get a paginated list of all builds for a user. Use when you need to retrieve build history across all actors. Supports pagination up to 1000 records.

ActionTry it

Get webhook

Tool to get webhook object with all details. Use when you need to retrieve complete information about a specific webhook by its ID.

ActionTry it

Get Webhook Dispatch

Tool to get webhook dispatch object with all details. Use when you need to retrieve information about a specific webhook dispatch including its status, event data, and call history.

ActionTry it

Get webhook dispatches

Tool to get list of webhook dispatches for a specific webhook. Use when you need to retrieve dispatch history for a particular webhook with pagination support.

ActionTry it

List Request Queue Requests

Tool to list requests in a request queue with pagination support. Use when you need to retrieve multiple requests from an Apify request queue.

ActionTry it

List User Actor Runs

Tool to get a paginated list of all Actor runs for the authenticated user. Use when you need to browse all runs across all actors, optionally filtered by status or date range.

ActionTry it

Prolong Request Lock

Tool to prolong request lock in a request queue. Use when you need to extend the lock duration on a previously locked request. Only the client that locked the request can prolong its lock.

ActionTry it

Resurrect Run

Tool to resurrect a finished Actor run. Use when you need to restart a completed or failed run. Deprecated endpoint; may be removed in future.

ActionTry it

Run Actor Asynchronously

Tool to run a specific Actor asynchronously. Use when you need to trigger an Actor run without waiting for completion and retrieve its run details immediately.

ActionTry it

Run Actor Sync

Tool to run a specific Actor synchronously with input and return its output record. Use when immediate Actor results are needed; runs may timeout after 300 seconds. To avoid timeouts, scope inputs to specific URLs rather than broad crawls and request only necessary fields (e.g., text or markdown).

ActionTry it

Run Actor Sync & Get Dataset Items

Tool to run Actor synchronously and get dataset items. Supports both actors that require input and those that don't. Use when immediate access to Actor results is needed. The run must finish within 300 seconds otherwise the request times out.

ActionTry it

Run Actor Sync & Get Dataset Items

Tool to run an Actor synchronously and retrieve its dataset items. Use when immediate access to run results is needed.

ActionTry it

Run Actor Sync without Input (GET)

Tool to run a specific Actor synchronously without input and return its output. Use when immediate Actor results are needed without providing input data; the run must finish within 300 seconds otherwise the HTTP request fails with a timeout error.

ActionTry it

Run Task Asynchronously

Tool to run a specific Actor task asynchronously. Use when you need to trigger a task run without waiting for completion and immediately retrieve its run details.

ActionTry it

Run Task Sync (GET)

Tool to run a specific task synchronously and return its output. Use when immediate task results are needed with pre-configured settings. The run must finish within 300 seconds otherwise the HTTP request fails with a timeout error.

ActionTry it

Run Task Sync (POST)

Tool to run an Actor task synchronously with input override and return its output. Use when immediate task results are needed with custom input parameters. The run must finish within 300 seconds otherwise the HTTP request fails with a timeout error (though the run continues server-side).

ActionTry it

Run Task Sync & Get Dataset Items

Tool to run an actor task synchronously and retrieve its dataset items. Use when immediate access to task run results is needed. The run must finish within 300 seconds otherwise the request times out. For large datasets exceeding the timeout, use `limit`/`offset` pagination to retrieve results in smaller batches or switch to an async run pattern with a separate dataset retrieval call.

ActionTry it

Run Task Sync with Input Override & Get Dataset Items

Tool to run an actor task synchronously with input overrides and retrieve its dataset items. Use when you need to override task input configuration and get immediate results. The run must finish within 300 seconds otherwise the request times out.

ActionTry it

Store Data in Dataset

Tool to store data items in a dataset. Use after collecting data when you want to batch-append or update items in an existing dataset.

ActionTry it

Store Data in Key-Value Store

Tool to create or update a record in a key-value store. Use after you have the store ID and record key to persist JSON data.

ActionTry it

Test Webhook

Tool to test a webhook by creating a test dispatch with a dummy payload. Use when you need to verify webhook configuration before production use.

ActionTry it

Unlock Queue Requests

Tool to unlock requests in a request queue that are currently locked by the client. If the client is within an Actor run, unlocks all requests locked by that specific run plus all requests locked by the same clientKey. If the client is outside of an Actor run, unlocks all requests locked using the same clientKey.

ActionTry it

Update Account Limits

Tool to update account limits manageable on the Limits page. Use when you need to set or modify the monthly spending cap (maxMonthlyUsageUsd) or data retention period (dataRetentionDays). At least one limit parameter must be provided.

ActionTry it

Update Actor

Tool to update Actor settings using JSON payload. Only specified fields will be updated. Use when you need to modify Actor configuration, make an Actor public, or update version settings.

ActionTry it

Update Actor Run Status Message

Tool to update the status message of an Actor run. Use when you need to set progress information or status updates that will be displayed in the Apify Console UI during Actor execution.

ActionTry it

Update Actor Task

Tool to update Actor task settings using JSON payload. Only specified properties are updated; others remain unchanged. Use when you need to modify task configuration, input, or execution options.

ActionTry it

Update Actor Version

Tool to update an Actor version's configuration and source code. Use when modifying version properties such as buildTag, sourceType, or environment variables. Only specified properties will be updated.

ActionTry it

Update Actor Version Environment Variable

Tool to update environment variable for a specific Actor version using JSON payload. Only specified fields will be updated. Use when modifying existing environment variables in Actor versions.

ActionTry it

Update Dataset

Tool to update a dataset's name via JSON payload. Use when you need to rename an existing dataset.

ActionTry it

Update Key-Value Store

Tool to update a key-value store's properties. Use when renaming or changing access of the store after confirming the store ID.

ActionTry it

Update Request in Queue

Tool to update a request in a request queue. Use when you need to modify request properties or mark a request as handled by setting handledAt to the current date/time. If handledAt is set, the request will be removed from the head of the queue and unlocked if applicable.

ActionTry it

Update Request Queue

Tool to update request queue name using JSON payload. Use when you need to rename an existing request queue.

ActionTry it

Update Schedule

Tool to update an existing schedule with new settings. Use when you need to modify schedule properties like cron expression, timezone, enabled status, or actions. Only specified fields are updated; others remain unchanged.

ActionTry it

Update Task Input

Tool to update the input configuration of a specific Actor task. Use when you need to modify a scheduled tasks input before execution.

ActionTry it

Update Webhook

Tool to update webhook using JSON payload. Only specified properties are updated; others remain unchanged. Use when you need to modify webhook settings like event types, target URL, or other configuration.

ActionTry it