Apify
Run Apify Actor (Async)
Start an Apify actor and return run details immediately without waiting for completion.
1 creditRuns in your Apify accountEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| identifieraccount · required | account | required | — |
| actorSourcestring · optional | string | optional | One of: Default: |
| actorIdstring · required | string | required | Select an actor to run |
| inputobject · optional | object | optional | Actor input JSON (object) |
| buildstring · optional | string | optional | Build tag (e.g. latest) |
| memoryMbytesnumber · optional | number | optional | — |
| timeoutSecsnumber · optional | number | optional | — |
| maxItemsnumber · optional | number | optional | Most items this run returns and is billed for. In a Workflow that runs on its own, set it to match the plan (no number in the request: ask, or state the number you chose; an actor example value is not the plan); left empty, every run returns whatever the actor gives by default, billed per item on the connected account. |
| maxTotalChargeUsdnumber · optional | number | optional | Most this run can charge, in USD, on the connected account. In a Workflow that runs on its own, set it with Max items so no run costs more than the plan expects; left empty, a run has no charge limit. |
Response schema
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"stats": {
"type": "object"
},
"status": {
"type": "string"
},
"userId": {
"type": "string"
},
"buildId": {
"type": "string"
},
"options": {
"type": "object"
},
"exitCode": {
"type": "integer"
},
"startedAt": {
"type": "string"
},
"finishedAt": {
"type": "string"
},
"buildNumber": {
"type": "string"
},
"containerUrl": {
"type": "string"
},
"statusMessage": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
}
}
}
}
}