GET /api/v1/search endpoint.
Core parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
q | string | required | Search query string. Also accepts a JSON array of up to 5 queries (e.g., ["query one", "query two"]). |
limit | integer | 10 | Maximum results to return (minimum 1) |
offset | integer | 0 | Results to skip for pagination |
depth | string | fast | Search mode: fast or deep |
intent | string | auto | Force search intent. See intent values below. |
Intent values
When not set, the API auto-detects intent from the query. You can force a specific intent using common aliases:| Alias | Description | Alias | Description |
|---|---|---|---|
search | General web search | news | Latest news results |
video | Video search | images | Image search |
weather | Weather data | calculate | Math computation |
wiki | Wikipedia/knowledge | knowledge | Academic knowledge |
code | Programming results | recipe | Recipe results |
place | Business search | places | Location search |
questions | Q&A results | time | Time queries |
FallbackSearchIntent, VideoSearchIntent) and resolves matches flexibly through exact match, case-insensitive match, and substring match.
Output parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
format | string | json | Response format: json or context. The context format returns results as markdown text, suitable for passing to language models. |
metadata | string | basic | Metadata level: basic or full. With full, results include contentType and reader data. |
extracts | boolean | false | Include longer text extracts from result pages |
Filtering parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
safe | boolean | false | Enable safe search filtering. Pass true to filter explicit content. |
country | string | US | ISO 3166-1 country code (e.g., US, GB, DE) |
language | string | en | ISO 639-1 language code (e.g., en, es, fr) |
units | string | auto | Unit system for weather/calculations: metric, imperial. Defaults based on country — imperial for US, metric for all others. |
Date filtering
| Parameter | Type | Description |
|---|---|---|
dateRange | string | Relative range: day, week, month, year, 24h, 7d, 30d, 90d, 1y |
dateFrom | date | Results published on or after this date (YYYY-MM-DD) |
dateTo | date | Results published on or before this date (YYYY-MM-DD) |
dateRange for relative filtering or dateFrom/dateTo for absolute date ranges. See filtering for details.
Domain filtering
| Parameter | Type | Description |
|---|---|---|
includeDomains | string | Comma-separated domains to restrict results to |
excludeDomains | string | Comma-separated domains to exclude from results |
*.example.com matches all subdomains. See filtering for details.
Term filtering
| Parameter | Type | Description |
|---|---|---|
includeTerms | string | Comma-separated terms that must appear in results |
excludeTerms | string | Comma-separated terms to exclude from results |
Content filtering
| Parameter | Type | Description |
|---|---|---|
filetype | string | File extension to filter by (e.g., pdf, doc) |
intitle | string | Term that must appear in the page title |
inurl | string | Term that must appear in the page URL |
intext | string | Term that must appear in the page body |
Behavior parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
noCache | boolean | false | Bypass cached results |
parseOperators | boolean | true | Parse query operators from the query string |