Skip to content
GetAllAPIs
APIsPricingNetworkDocsPlaygroundFree tools
Dashboard Get started
APIsPricingNetworkDocsPlaygroundFree toolsDashboardGuidesFAQ Get started

Docs

  • Overview
  • Quickstart
  • API keys, spend limits and access levels
  • Running endpoints: envelope, response controls, max cost
  • Durable (async) requests and request history
  • Errors and billing semantics
  • Wallet and pricing
  • MCP server
  • Let an agent sign itself up
  • CLI and Python SDK
  • Audit log, retention, billing and feedback
  • Pagination and large results
  • Data sources and modes
  • SEO audit
  • Keyword gap report
  • Content brief
Docs / Running endpoints: envelope, response controls, max cost

Running endpoints: envelope, response controls, max cost

On this page
  • Response controls (shape the output, never the cost)
  • Cost guard
  • Idempotency
  • Quote first

POST /v1/run/{endpoint_id} with the endpoint's input as the JSON body. Endpoint ids and schemas: GET /v1/catalog/{endpoint_id}.

Response controls (shape the output, never the cost)

Query parameterEffect
fields=summary.score,actions.actionKeep only these (dotted) paths; lists of objects are filtered per item
max_items=5Cap every list; _truncated reports how many rows were withheld per path
summary=trueReturn an outline (type, item count, bytes per top-level key) instead of the data
jq=…Accepted but not executed on this server: full output returned with jq_error

A large unshaped response carries hint: "large_result: …".

Cost guard

max_cost_usd=0.50 refuses the call before it runs if it would cost more (402 max_cost_exceeded, nothing charged, message states the price).

Idempotency

Send Idempotency-Key: <your id> on paid calls. Same key + same body within 24 h → original response, no new charge, Idempotency-Replayed: true. Same key + different body → 409 idempotency_conflict. Same key while the first call is still running → 409 idempotency_in_progress (retry after Retry-After). Failed calls are not cached.

Quote first

POST /v1/quote/{endpoint_id} validates the input and returns cost_usd, available, and with a key balance_usd, limit_remaining_usd, can_run. Free; nothing runs.

Plain Markdown for agents: /docs/running.md · index: llms.txt

Product

  • API catalog
  • Pricing
  • Site audit
  • Playground
  • Dashboard
  • Network

Free tools

  • All free tools
  • Title & description checker
  • robots.txt tester
  • Sitemap validator
  • hreflang checker
  • Heading outline
  • Structured data checker
  • Social preview
  • Indexability checker

Learn

  • Guides
  • Check reference
  • Use cases
  • Compare
  • Glossary

Developers

  • Docs
  • Quickstart
  • MCP server
  • Agent guide
  • llms.txt
  • OpenAPI

Company

  • About
  • FAQ
  • Changelog
  • Data sources
  • Contact
  • Security

Legal

  • Terms of Service
  • Privacy Policy
  • Refund Policy
  • Acceptable Use
  • Data Processing
GetAllAPIs © 2026 Mohamed Outerbah · [email protected]