AlterLab icon

AlterLab

Scrape any website with anti-bot bypass, JS rendering, structured extraction, OCR, and more

Actions2

Search

AI-generated

Summary

Perform a search query to retrieve relevant search results with optional scraping and structured extraction for each result. Supports selecting different search engines including DuckDuckGo (fastest), Google, and Bing (browser-rendered, richer results) with configurable safe search filtering, pagination, geographic and language targeting, and result filtering by domain and recency.

Inputs

  • searchQuery (required) — Search terms (max 500 characters) specifying what to find.
  • searchOptions.engine — Select the search engine: DuckDuckGo (fast, cheapest), Google (browser tier), or Bing (browser tier). Google and Bing use browser rendering to return richer results at a higher price.
  • searchOptions.safeSearch — Boolean to filter adult content from results (default true).
  • searchOptions.numResults — Number of results to return, from 1 to 30 (default 10).
  • searchOptions.page — Result page number (1-indexed), from 1 to 10 (default 1).
  • searchOptions.country — ISO 3166-1 alpha-2 country code to geo-target results (e.g., US, GB, DE).
  • searchOptions.language — Language code to filter results by language (e.g., en, fr, de).
  • searchOptions.domain — Restrict results to a specific domain using a site: prefix filter.
  • searchOptions.timeRange — Filter results by recency with options from Any Time to Past Year.
  • searchOptions.scrapeResults — Boolean to scrape each result page and include content in the response.
  • searchOptions.scrapeFormats — Output formats when scraping is enabled. Options include Content (AI/KB), HTML, JSON, JSON V2 (Section Tree), Markdown, RAG (Chunked), and Text.
  • searchOptions.extractionSchema — JSON schema for structured extraction applied when scraping each result page.

Output shape

A JSON object representing the search results including metadata and optional scraped content and extracted data per result.

Returns a JSON object representing the search results including metadata and an array of results. Each result includes fields such as URL, title, author, publication date, HTTP status, cached status, response time, document size, and optional scraped content in the requested formats when scraping is enabled. Supports asynchronous polling until scraping completes. Advanced metadata such as extraction method, screenshot/PDF URLs, OCR results, raw HTML, and detailed billing info are also included.

Links

Discussion