Skip to content

Overview

Scraping orchestration API. Route requests across multiple providers (Bright Data, Oxylabs, Nimble Way, Zyte, Decodo) with automatic fallback, cost optimization, structured extraction, and warehouse delivery.

Authentication

Every request requires a Bearer token: a JWT from the dashboard or an sr_* API key from Settings → API Keys. New orgs get a default key on signup that survives until you revoke it.

Errors

All endpoints emit JSON errors via { "error": "<message>" }. CLI and MCP clients that send Accept: application/vnd.justcrawl.v1+json receive a structured shape: { "error": { "code", "message", "docs_url", "request_id" } } (see https://docs.justcrawl.io/errors).

Rate limits

Per-org quota gates apply to POST /api/v1/jobs and other write paths. Token-bucket X-RateLimit-* headers ship in a future release; today the gate emits 402 Insufficient credits when an org’s quota is exhausted.

Informations

JWT access token or API key. Get an API key from Settings > API Keys.

Security scheme type: http

Bearer format: JWT