Search
Search the web, news, images, scholarly papers, companies and people in one call. Send one request and get JSON back. Examples in cURL, TypeScript and Python.
Price
2 credits per 10 results from each source and each research, companies, people or developer list, plus 1 credit for each web result that comes back with its page text when scrapeOptions is on. See Pricing for what credits cost.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Cut every text value in the response to this many characters. A value that was cut ends with …, and a page whose text was cut has isTruncated set to true. A screenshot is never cut. Leave it out to get the full text.
x >= 1Body
1 - 400What to search: web, news, images. Each is a string or {type}. Default web, or none when categories asks for research, companies, people or developer.
1 - 3 elementsweb, news, images pdf: web results that are PDF files. research: scholarly papers, in a research list, ranked by relevance then citations. companies: companies that match the query, in a companies list, best matches first. The query can name a place, industry, employee count, founding year and funding stage, like fintech startups in Berlin, 50-200 employees. people: people that match the query, in a people list, best matches first. The query can name a role, company, place or research topic, like CFO of Stripe, founders of fintech startups in Berlin, or researchers on CRISPR base editing. Each person has roles, affiliations and public profile links, never contact details. developer: passages from GitHub READMEs, issues, merged pull requests, releases, developer docs and API operations, in a developer list; send it as an object to filter by repos, types, language and minStars.
developer, gov, research, pdf, companies, people Accept a stored answer up to this many milliseconds old, at most 30 days. Without it, 15 minutes for news and 1 hour for web and images. 0 always searches live.
0 <= x <= 9007199254740991Most results to return for each source. Default 10, or 5 with scrapeOptions, which reads at most 5 pages. News returns at most 50.
1 <= x <= 100Time filter: qdr:h, qdr:d, qdr:w, qdr:m or qdr:y, or cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY. Web takes both; news takes qdr only; images take none.
1Where to search from, like Germany or San Francisco,California,United States. The last part is the country and replaces country. A city before it narrows web results to that place.
1Two-letter country to search from, like us. Image results are always US.
^[A-Za-z]{2}$1010Hide explicit web and image results when true.
Milliseconds to wait for the sources.
1000 <= x <= 9007199254740991Leave out results whose address cannot be read as a page.
On by default. When a web result's page is already stored, its description is the passages of that page that best match the query. Send false for the snippet the search engine shows.
"compact"Reads the top web results, up to 5, and puts the passages that best match the query in each description. Add "markdown" to formats to get the whole page text too. Costs 1 more credit for each page read.