Performs a web search and returns structured results. Supports fast (default) and deep search modes, domain and date filtering, query operators, and multiple output formats.
API key from the API Console.
Search query string. Supports query operators when parseOperators is enabled. You can also pass a JSON array of up to 5 queries for multi-query searches (e.g., ["query one", "query two"]).
Maximum number of results to return.
x >= 1Number of results to skip for pagination.
x >= 0Search depth. fast returns results in ~1 second. deep enables spell correction, enhanced analysis, and more sources in ~2–3 seconds.
fast, deep Force a specific search intent. When not set, the API auto-detects intent from the query. Accepts common aliases like search, news, video, images, weather, wiki, code, recipe, place, time, and others.
Response format. json returns a JSON object. context returns results as markdown text, suitable for passing to language models.
json, context Level of metadata to include. basic includes standard search metrics. full includes extended metadata with content type details and reader data on results.
basic, full Include text extracts from result pages in the response.
Enable safe search filtering. Pass true to filter explicit content.
Two-letter ISO 3166-1 country code to localize results.
Two-letter ISO 639-1 language code to filter results by language.
Unit system for weather and calculation results. Defaults based on the country parameter — imperial for US, metric for all other countries.
metric, imperial Bypass cached results and fetch fresh data.
Relative date range filter for results.
day, week, month, year, 24h, 7d, 30d, 90d, 1y Filter results published on or after this date. Format: YYYY-MM-DD.
Filter results published on or before this date. Format: YYYY-MM-DD.
Comma-separated list of domains to restrict results to. Supports wildcards (*.example.com).
Comma-separated list of domains to exclude from results. Supports wildcards.
Comma-separated terms that must appear in results.
Comma-separated terms to exclude from results.
Parse query operators (like site:, filetype:, intitle:) from the query string. When disabled, the query is treated as literal text.
Filter results by file type.
Filter results to pages with this term in the title.
Filter results to pages with this term in the URL.
Filter results to pages with this term in the body text.
Search results
The type of search results returned (e.g., search, news, images).
A generated answer for the query. May be an empty string when no direct answer is available.
Same as results_type. Indicates the category of results.
A title summarizing the search results.
Array of search results.
Search performance metrics. Always included in the response.
Spell-corrected query. Only present when deep search detects and corrects a misspelling in the original query.
Related search suggestions. Present on some queries.
Related topics. Present on some queries.
Video results. Present when the query triggers a video intent.
Image results. Present when the query triggers an image intent.
News results. Present when the query triggers a news intent.
Place/business results. Present for location-related queries.
Profile results. Present for people-related queries.
Social media results. Present for social-related queries.
Academic results. Present for scholarly queries.
Weather data. Present when the query triggers a weather intent.
Calculation result. Present when the query triggers a calculation intent.