Search the web
Search the web and get structured results. Returns ranked results with titles, snippets, and URLs.
Location and language resolution:
- If
locationis set butlanguageis not, the language auto-resolves to the most predominantly used language in that country. - If
languageis set butlocationis not, the location auto-resolves to the country where that language is most predominantly used. - If neither
locationnorlanguageis set, defaults toUSanden.
Authorizations
API key for authentication. Get your key from the API Keys page.
Query Parameters
Search query
1 - 2000"web automation tools"
Why this search is being run — the underlying goal or task the results will be used for. Used to better rank results against your intent.
1 - 2000"Find an open-source library for parsing PDF invoices in Python"
Country code for geo-targeted results
"US"
Language code for result language
"en"
Type of search to perform: "web" for standard results, "news" for news articles, "research_paper" for academic papers. Defaults to "web".
web, news, research_paper "news"
Return results after this date (YYYY-MM-DD)
"2024-01-01"
Return results before this date (YYYY-MM-DD)
"2024-12-31"
Return results from the past N minutes (1 to 5,256,000).
1 <= x <= 525600060
Page number for pagination, starting from 0 (max 10)
0 <= x <= 102
When "true", each result includes a thumbnail_url when available. Defaults to false.
true, false "true"
JSON-encoded fetch configuration object.
256"{}"
Response
Search completed successfully.