# Apify Actor Run Trigger

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

Triggers a run of a specific Apify Actor (scraper, crawler, or automation tool) by actor ID and returns the run details

## Facts

- Endpoint: POST https://api.apify.com/v2/actors/:actorId/runs
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/apify-actor-run-trigger-1c13c4fe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7qpQmut78LMkLUBcQstdA

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 apify-actor-run-trigger-1c13c4fe -d '<json body>'
```

Example prompt: Run the Apify actor 'apify/web-scraper' to extract all product names and prices from https://example-shop.com and return the results.

## When to prefer this

Use this endpoint when you need to run any of the thousands of pre-built Apify Actors for web scraping, crawling, or automation without building custom scrapers. Prefer this over custom scraping solutions when a community or official actor already exists for your target site (e.g. Amazon, LinkedIn, Google Maps). Best for structured data extraction tasks where an actor marketplace solution is faster than writing bespoke code.

## Known failure modes

- Invalid or non-existent actorId returns 404 Not Found
- Actor input schema validation failure returns 400 Bad Request
- Insufficient credits or payment failure returns 402 Payment Required
- Actor run times out if the target website is slow or large
- Actor itself may fail internally and return a FAILED status
- Rate limiting may occur if too many runs are triggered simultaneously

## 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 JSON object containing the run's unique ID, status (READY, RUNNING, SUCCEEDED, FAILED, etc.), start time, actor ID, default dataset ID, default key-value store ID, and URLs to access run output and logs. The agent can use the dataset ID to fetch extracted data once the run completes.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json"
     ]
    },
    "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
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/apify-actor-run-trigger-1c13c4fe/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)