{"uid":"cap_7qpQmut78LMkLUBcQstdA","slug":"apify-actor-run-trigger-1c13c4fe","name":"Apify Actor Run Trigger","description":"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.","url":"https://api.apify.com/v2/actors/:actorId/runs","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3imjnxRiLGH-LYUN9foRx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Triggers a run of a specific Apify Actor (scraper, crawler, or automation tool) by actor ID and returns the run details","exampleAgentPrompt":"Run the Apify actor 'apify/web-scraper' to extract all product names and prices from https://example-shop.com and return the results.","exampleUseCases":[{"title":"E-commerce product data extraction","prompt":"Use the Apify actor 'apify/amazon-scraper' to scrape all product listings for 'wireless headphones' from Amazon and give me the names, prices, and ratings."},{"title":"Real estate listings scraper","prompt":"Trigger the 'dtrungtin/realtor-scraper' Apify actor to pull all house listings in Austin, TX under $500,000 from Realtor.com and return the addresses and prices."},{"title":"Social media content monitoring","prompt":"Run the Apify actor 'quacker/twitter-scraper' to collect the last 100 tweets mentioning 'climate change' from this week and extract the text and engagement counts."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:27.258Z","isFirstParty":false}