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 / Errors and billing semantics

Errors and billing semantics

Every error has one shape:

{"ok": false, "request_id": "req_…",
 "error": {"code": "insufficient_balance", "message": "…", "retryable": false, "billed": false}}

billed is always false for errors: invalid input is rejected before charging, and source failures are refunded automatically.

HTTPCodeMeaning
400invalid_input, invalid_idempotency_keyBad parameters
401unauthorizedMissing, wrong, disabled or expired key
402insufficient_balanceWallet too low; top up
402trial_cap_reachedAgent trial budget spent; body has upgrade
402spend_cap_exceededThis key's spend limit reached
402max_cost_exceededCall costs more than max_cost_usd; body has price_usd
403forbidden, signup_disabledAccess level or server policy
404not_found, result_expiredUnknown id, or stored result past retention
409idempotency_conflict, idempotency_in_progress, primary_keySee Running / API keys
422invalid_input, site_unreachableValidation; the audited site could not be fetched (refunded)
429rate_limitedPer-key limit; honour Retry-After
501not_available, billing_not_configuredNot offered in this mode/server; not charged
502provider_unavailableSource failed; refunded; retryable
500internal_errorUnexpected; retryable

A partial report (an optional source failed) is a success: charged, with output.partial: true and the failures listed.

Rate limit: 120 requests/minute per key by default (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset).

Plain Markdown for agents: /docs/errors.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]