Search
Search the web, news, images, scholarly papers and YouTube videos in one call.
Authorizations
Headers
A value you choose for one call. Send the same key with the same method, path and body within 24 hours and the first answer comes back with idempotent-replayed: true, with the same cost headers and no second charge. A call that sends zeroDataRetention and answers with page data is not kept, so a retry runs again. Needs an API key.
Query Parameters
Body
What to search for, up to 500 characters. Search operators work in web results: quotes for an exact phrase, -word, site:, -site:, filetype:, inurl:, allinurl:, intitle: and allintitle:. In image results, imagesize:WIDTHxHEIGHT keeps images of exactly that size and larger:WIDTHxHEIGHT keeps images at least that large.
1 - 500pdf: web results that are PDF files. research: scholarly papers, in a research list, ranked by relevance then citations. videos: YouTube videos for the query, in YouTube's order, in a videos list, with the channel, length, views and watch link; a video whose captions we hold also gets the passage that matches the query and where it starts.
research, pdf, videos With scrapeOptions formats: read only the top this many web results and the top this many news results, and return the other results without page text. Cannot be more than limit. Without it every result returned is read. Only pages that are read are charged for.
1 <= x <= 100Milliseconds to wait for the sources, from 1,000 to 120,000; more is read as 120,000. Default 3,000, or 60,000 when scrapeOptions has formats and the search reads pages. A source that has not answered by then is left out with a warning. When none has, the call fails and costs nothing.
1000 <= x <= 9007199254740991With formats, reads each web and news result, as many as scrapeLimit or limit asks for, within timeout, and fills each web result's description from it. Without formats no page is read and nothing more is charged. Takes the options of scrape: formats (markdown, html, rawHtml, links, images, summary, screenshot, json and the rest), onlyMainContent, includeTags, excludeTags, maxAge, minAge, waitFor, mobile, timeout (per page), headers, actions, location, parsers, profile and zeroDataRetention. redactPII uses patterns on web descriptions, news snippets, research snippets and video snippets, even without formats, when sources has web or news. Titles and URLs are unchanged. Snippets can still contain names and places that patterns miss. With formats, page reads and their add-ons use scrape pricing, starting at $1 per 1,000 pages for a standard read.