{"uid":"cap_r6ns-LuL8GcwUSJQI09Si","slug":"api-apify-com-01406fed","name":"Apify Actor Run - Start Actor Execution","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/acts/: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_MfQUBCGr6iPrRA-unGCvW","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 new run of a specified Apify Actor (scraper, crawler, or automation tool) on the Apify platform","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:25.474Z","isFirstParty":false}