SuperScraper API

Web scraping and structured extraction API for developers and agents.

Turn any URL into LLM-ready data, and any company into a fused, confidence-scored profile. Every structured field carries a confidence score and a source trail, Smart fallback fetching (plain HTTP, then Playwright, then stealth) and a free JSON-LD extraction layer that costs nothing when a site already ships structured data.

Quick start

curl -X POST https://api.superscraper.dev/v1/scrape \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Response:

{
  "url": "https://example.com",
  "markdown": "# Example Domain\n\nThis domain is for use in illustrative examples...",
  "listing": null,
  "metadata": {
    "fetchMethod": "plain",
    "latencyMs": 312
  },
  "ok": true
}

Products

Product	What it does
Developer API	Scrape, crawl, extract, map, and enrich via REST
Pre-built scrapers	Google Maps, Yelp, Yellow Pages, directory batch
MCP server	Hosted MCP is not available. Use REST; local stdio is developer-only

Authentication

All API requests require an x-api-key header:

-H "x-api-key: ss_live_xxxxxxxxxxxxxxxxxxxx"

Get your API key at app.superscraper.dev (opens in a new tab).

Base URL

https://api.superscraper.dev

If custom DNS is not yet live in your network, use the Railway URL from the dashboard (same API):

https://superscraper-production-1381.up.railway.app

All endpoints are versioned under /v1/.

Credits (free beta)

Billable routes return:

Header	Meaning
`X-Credits-Consumed`	Credits charged for this request (0 on no-hit / free ops)
`X-Credits-Remaining`	Balance after the charge (when available)

Free tier includes monthly scrape + enrich grants. Exhausted balance returns HTTP 402. JSON-LD-only extract is free. Live pricing: GET /v1/pricing.

Rate limits

Rate limits are enforced per API key in a 60-second sliding window. Exceeding the limit returns HTTP 429 with a Retry-After: 60 header.

Plan	Requests / minute
Free	10
Hobby	60
Pro	200
Scale	600
Custom	3 000

Endpoints at a glance

Core scraping

Endpoint	Method	Description
`/v1/scrape`	POST	Scrape a single URL → markdown + listing data
`/v1/extract`	POST	Extract structured JSON from a URL or HTML
`/v1/crawl`	POST	Async crawl, queue a multi-page job
`/v1/jobs/:id`	GET	Poll crawl job status
`/v1/jobs`	GET	List recent crawl jobs
`/v1/map`	POST	Enumerate all URLs on a site
`/v1/batch`	POST	Scrape up to 100 URLs in a single request
`/v1/search`	POST	Web search (DataForSEO → DuckDuckGo → Bing) with optional LLM answer
`/v1/screenshot`	POST	Render a page with Playwright and return a screenshot

Pre-built scrapers

Endpoint	Method	Description
`/v1/scrapers/google-maps`	POST	Google Maps business search by keyword + location
`/v1/scrapers/yelp`	POST	Yelp business search
`/v1/scrapers/yellow-pages`	POST	Yellow Pages business search
`/v1/scrapers/directory`	POST	Batch scrape a generic business directory

Enrichment

Endpoint	Method	Description
`/v1/enrich/website`	POST	B2B website enrichment (emails, phones, tech stack, team)
`/v1/enrich/phone`	POST	Resolve and verify a public business phone line
`/v1/enrich/batch`	POST	Enrich many records across fields in one call
`/v1/enrich/estimate`	POST	Side-effect-free quote for a batch enrichment

Billing & usage

Endpoint	Method	Description
`/v1/usage`	GET	Current-period page and extraction usage + quota
`/v1/billing/checkout`	POST	Start a Stripe Checkout session for a plan upgrade
`/v1/billing/portal`	GET	Open the Stripe Billing Portal for an existing subscription

Public (no auth)

Endpoint	Method	Description
`/health`	GET	Health check
`/llms.txt`	GET	Condensed API reference for AI agents
`/llms-full.txt`	GET	Full API reference for AI agents
`/openapi.json`	GET	OpenAPI 3.x spec

Quickstart