Skip to main content
Scrape reads one URL and returns the outputs you list in formats. Send several formats in one request. Without formats, you get markdown.

Make a request

Get an API key in the Quickstart. This request returns the main content of a docs page as Markdown, plus every link on it.
You can try Scrape without an API key, up to 10 calls a minute and 50 calls a day per IP address. See Rate limits.

Read the response

Each format you asked for is a field of data. This real response is cut to a few lines. The full Markdown was 48,826 characters, and links held 105 URLs.
metadata describes the page whatever formats you ask for: its title, description, language, status code and social tags. See Page metadata. costUsd is what the call cost. To read the same result again within 24 hours, send GET /v1/scrape/{id} with the id. See Freshness and caching.

Formats

Shape the page visit

Run browser actions before the page is read, or keep working on it in a browser session. Set waiting and rendering, keep only the parts you want with content filtering, and pick a country or send headers with location and headers. Read PDFs and documents the same way as pages. Choose how old a stored copy may be with freshness and caching, scan for prompt injection or redact personal data with safety, and handle failures with timeouts and errors. The full field list is in the API reference.

Price

$1 per 1,000 pages. A page that comes back with a 404 or 410 status, or cannot be read, costs nothing. `json` with a schema or a prompt, `summary`, `highlights`, `question`, `product`, `menu` and `changeTracking` in `json` mode each add $3 per 1,000 pages when they return something. Browser actions and CSS rules add nothing. See Pricing.

Choose another API

  • Map lists the pages of a site without reading them.
  • Crawl reads every page of a site in the background.
  • Batches read a list of URLs in the background.
  • Search finds pages from a query and can read each result.
  • Extract pulls the fields you name from one or more pages, each checked against the page.
  • Parse documents turns a file you upload into Markdown.