Web data API: scrape, map, metadata, screenshots, search, PDF

Quickstart

1. Send the request below. Without payment it returns HTTP 402 with the x402 payment requirements.
2. Pay $0.008 USDC on Base with any x402 client and retry. Most clients do this step for you.
3. You get the page back as markdown. You are charged only on success; if every provider fails you get a 502 and pay nothing.

curl -i -X POST https://api.switch402.com/v1/scrape \
  -H 'content-type: application/json' \
  -H 'user-agent: my-agent/1.0' \
  -d '{"url":"https://example.com"}'

Send your own User-Agent header (for example my-agent/1.0); some default library user-agents are blocked at the edge. A lite endpoint, POST https://api.switch402.com/v1/scrape/lite, is $0.003 per call.

How it works

1. 1
   Call one endpoint

   Send a scrape request to a single switch402 URL.

2. 2
   We pick the provider

   We route to multiple verified x402 scrape providers. Any that failed their last check are skipped, and a failed call fails over to the next.

3. 3
   Pay per call

   Pay $0.008 USDC on Base over x402, only on success. No plan required; optional prepaid packs and a $10 monthly lite plan, and nothing expires: leftover balance stays on your key.

Today switch402 covers page to markdown, site maps, page metadata, screenshots, web search and PDF to text.

Want to see when pay-per-call beats a monthly plan? Try the cost calculator.

Pricing

Pay per successful call in USDC on Base over x402. No signup or plan required. Failed calls cost nothing.

• Scrape$0.008 per page
  /v1/scrape

  Any public page as clean markdown, with automatic failover.

• Scrape lite$0.003 per page
  /v1/scrape/lite

  /v1/scrape/lite: $0.003 per page. A page as markdown, charged only on success.

• Site map$0.001 per call
  /v1/map

  Lists a site's pages: the same-site links on a page plus the URLs in its sitemap, deduped, up to 1,000.

• Page metadata$0.001 per call
  /v1/metadata

  Reads a page's title, description, canonical URL, language, social (OpenGraph and Twitter) tags and JSON-LD structured data.

• Screenshot$0.008 per call
  /v1/screenshot

  The visible 1280x800 viewport of a page, JavaScript rendered, as a PNG.

• Full-page screenshot$0.012 per call
  /v1/screenshot/full

  The whole scrollable page as a PNG.

• Web search$0.008 per call
  /v1/search

  Up to 10 ranked web results for a query, each with title, URL and snippet.

• PDF to text$0.008 per call
  /v1/pdf

  The text of a public PDF, page by page: up to 10 MB and 50 pages, optional page selection. Not charged if extraction fails.

• QuoteFree
  /v1/quote

  The price and availability for a URL before you pay.