Apify

Learn how to use Apify with Composio

Overview

SLUG

APIFY

Description

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

Authentication Details

generic_api_key
stringRequired

Tools

SLUG: APIFY_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.

Action Parameters

categories
array
defaultRunOptions
object
description
string
isDeprecated
boolean
isPublic
boolean
name
stringRequired
title
string
versions
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_CREATE_DATASET

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

Action Parameters

name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_CREATE_TASK

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

Action Parameters

actId
stringRequired
name
stringRequired
options
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

condition
objectRequired
description
string
eventTypes
arrayRequired
headersTemplate
string
idempotencyKey
string
isAdHoc
boolean
payloadTemplate
string
requestUrl
stringRequired
shouldInterpolateStrings
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

actorId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_DELETE_WEBHOOK

Tool to delete a webhook by its id. use when removing a webhook after confirming the webhook id.

Action Parameters

webhookId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_GET_ACTOR

Tool to get details of a specific actor. use when you need actor metadata by id or username/actorname.

Action Parameters

actorId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

desc
boolean
limit
integer
offset
integer

Action Response

data
arrayRequired
error
string
limit
integerRequired
offset
integerRequired
successful
booleanRequired
total
integerRequired

SLUG: APIFY_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.

Action Parameters

asciiHeaders
boolean
attachment
boolean
bom
boolean
clean
boolean
datasetId
stringRequired
delimiter
string
desc
boolean
fields
string
flatten
boolean
format
stringDefaults to json
limit
integerDefaults to 1000
offset
integer
offsetKey
string
omit
string
skipEmpty
boolean
skipHidden
boolean
unwind
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

actorId
stringRequired
waitForFinish
number

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

attachment
boolean
disableRedirect
boolean
format
string
recordKey
stringRequired
storeId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

actorId
stringRequired
desc
boolean
limit
integer
offset
integer
status
string
unnamed
boolean
waitForFinish
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

actorId
stringRequired
desc
boolean
limit
integerDefaults to 1000
offset
integer
status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

desc
boolean
limit
integerDefaults to 1000
offset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

actorTaskId
stringRequired
desc
boolean
limit
integerDefaults to 1000
offset
integer
status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

actorTaskId
stringRequired
desc
boolean
limit
integerDefaults to 1000
offset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_GET_LOG

Tool to retrieve logs for a specific actor run or build. use after initiating an actor run or build when you need to inspect execution logs.

Action Parameters

buildOrRunId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_GET_OPEN_API_DEFINITION

Tool to get the openapi definition for a specific actor build. use when you need the api schema for code generation or analysis.

Action Parameters

actorId
stringRequired
buildId
stringRequired
token
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

taskId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

runId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_RUN_ACTOR

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.

Action Parameters

actorId
stringRequired
body
object
build
string
maxItems
number
maxTotalChargeUsd
number
memory
number
timeout
number
waitForFinish
number
webhooks
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

actorId
stringRequired
build
string
input
objectRequired
maxItems
integer
maxTotalChargeUsd
number
memory
integer
outputRecordKey
string
timeout
number
webhooks
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

actorId
stringRequired
format
stringDefaults to json
input
object
limit
integerDefaults to 100
offset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_RUN_TASK

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.

Action Parameters

actorTaskId
stringRequired
body
object
build
string
maxItems
number
maxTotalChargeUsd
number
memory
number
timeout
number
waitForFinish
number
webhooks
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

data
arrayRequired
datasetId
stringRequired
deduplicate
boolean
fields
string
omit
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

recordKey
stringRequired
recordValue
objectRequired
storeId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_UPDATE_KEY_VALUE_STORE

Tool to update a key-value store's properties. use when renaming or changing access or schema version of the store after confirming the store id.

Action Parameters

access
string
name
string
schemaVersion
integer
storeId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: APIFY_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.

Action Parameters

input
objectRequired
taskId
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired