All tools

Web · apify_run_actor

Run an Apify actor

Run an Apify scraper and return its results (billed at actual cost on the EZYAGENTS key, usually 1 to 3 credits, included with your own Apify key).

Price
3 credits / call
≈ €0.234 · $0.255 · debited by the tool, per result
Requirements
No connector
also works with Apify
Human approval
No
read or internal write
Reliability
Verified
not measured yet

Input

FieldTypeDescription
actorId *stringusername/name
input *objectActor input matching its schema
maxItemsnumberMax dataset items returned (1-200, default 50)
timeoutSecondsnumber10-120, default 90
maxCreditsnumberSpend ceiling for this run in credits (default 3; the Apify spend cap derives from it)

Call this tool

Through the HTTP API, or from the MCP server with the run meta-tool.

curl https://api.ezyagents.fr/gateway/v1/run \
  -H "Authorization: Bearer ezk_…" -H "Content-Type: application/json" \
  -d '{"tool":"apify_run_actor","input":{"actorId":"…","input":"…","maxItems":1,"timeoutSeconds":1}}'
$run({ "tool": "apify_run_actor", "input": {"actorId":"…","input":"…","maxItems":1,"timeoutSeconds":1} })