# Apify Actor Run - Start Actor Execution

> Apify Actor Run - Start Actor Execution is a paid API for AI agents from api.apify.com, paid per call via x402, $1/call, status unknown (last checked 2026-09-14).

Triggers a new run of a specified Apify Actor (scraper, crawler, or automation tool) on the Apify platform

## Facts

- Endpoint: POST https://api.apify.com/v2/acts/:actorId/runs
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-apify-com-01406fed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_r6ns-LuL8GcwUSJQI09Si

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability api-apify-com-01406fed -d '<json body>'
```

Example prompt: Run the Apify Actor 'apify/web-scraper' to scrape all product listings from https://example-shop.com/products and return the results — use 1024 MB of memory and default build.

## When to prefer this

Use this endpoint when you need to programmatically trigger any of the thousands of pre-built Apify Actors (scrapers, crawlers, automation bots) available in Apify Store, especially when you need web data extraction at scale without building a custom scraper. Prefer this over building your own scraper when a suitable Actor already exists in the Apify marketplace.

## Known failure modes

- 404 Not Found if actorId does not exist or is misspelled
- 401 Unauthorized if API token is missing or invalid
- 400 Bad Request if the input JSON does not match the Actor's expected schema
- 402 Payment Required if the x402 payment of $1 USDC is not included or fails
- 429 Too Many Requests if rate limits are exceeded
- Actor run may fail internally (status FAILED) if the target website is unreachable or the Actor encounters a runtime error

## How this service works

Apify Store is the largest marketplace of tools for AI agents. Extract data from any website and automate your workflows with thousands of scrapers, crawlers, and automation tools called Actors.

## Output

Returns a run object containing a unique run ID, current status (READY, RUNNING, SUCCEEDED, FAILED, etc.), and IDs for the associated dataset, key-value store, and request queue where output data will be stored once the Actor completes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "description": "Actor input JSON. Each Actor on Apify Store defines its own input schema. Browse and inspect schemas at https://apify.com/store (Actor detail pages can be rendered in markdown by appending .md to their URL), or call the Apify API to fetch the schema for a specific Actor.",
     "additionalProperties": true
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-apify-com-01406fed/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.apify.com](https://www.zero.xyz/host/api.apify.com/llms.txt)