Extraction Parameter for POST /v1/search

POST /v1/search now accepts an extraction object that controls what text comes back with each result. Two modes are available:

  • extraction_mode: "highlights" returns contents.highlights—the passages from each page most relevant to your query, sized for token-sensitive agentic workflows. Snippets are omitted.
  • extraction_mode: "full_page" returns contents.markdown or contents.html carrying the full page, alongside the default snippets.

The extraction parameter is available on POST /v1/search only. GET /v1/search continues to support livecrawl for full page content. Set extraction.full_page.extraction_formats to ["markdown"], ["html"], or both.

Full page extraction is billed at $1.00 per 1,000 pages on top of the base Web Search API rate.

Read the Web Search API overview