Skip to main content
All parameters are passed as query string parameters on the GET /api/v1/search endpoint.
Most integrations only need q, limit, and depth. The filtering and output parameters below are available when you need more control.

​
Core parameters

ParameterTypeDefaultDescription
qstringrequiredSearch query string. Also accepts a JSON array of up to 5 queries (e.g., ["query one", "query two"]).
limitinteger10Maximum results to return (1–100)
offsetinteger0Results to skip for pagination
depthstringfastSearch mode: fast (single search, ~1s) or deep (searches from multiple angles for higher-quality results, ~2–3s)
intentstringautoForce 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:
AliasDescriptionAliasDescription
searchGeneral web searchnewsLatest news results
videoVideo searchimagesImage search
weatherWeather datacalculateMath computation
wikiWikipedia/knowledgeknowledgeAcademic knowledge
codeProgramming resultsrecipeRecipe results
placeBusiness searchplacesLocation search
questionsQ&A resultstimeTime queries
The API also accepts full intent names (e.g., FallbackSearchIntent, VideoSearchIntent) and resolves matches flexibly through exact match, case-insensitive match, and substring match. 
# Force news intent
curl "https://search-api.andisearch.com/api/v1/search?q=AI+startups&intent=news" \
  -H "x-api-key: YOUR_API_KEY"

​
Output parameters

ParameterTypeDefaultDescription
formatstringjsonResponse format: json or context. The context format returns results as markdown text, suitable for passing to language models.
metadatastringbasicMetadata level: basic or full. With full, results include contentType and reader data.
extractsbooleanfalseInclude longer text extracts from result pages
# Get results as markdown for LLM context
curl "https://search-api.andisearch.com/api/v1/search?q=machine+learning&format=context" \
  -H "x-api-key: YOUR_API_KEY"

# Get results with text extracts
curl "https://search-api.andisearch.com/api/v1/search?q=machine+learning&extracts=true" \
  -H "x-api-key: YOUR_API_KEY"
metadata=full adds latency because it fetches additional data from each result page. Use it only when you need contentType or reader data.

​
Filtering parameters

ParameterTypeDefaultDescription
safestringoffSafe search level: off, moderate, or strict
countrystringUSISO 3166-1 country code (e.g., US, GB, DE)
languagestringenISO 639-1 language code (e.g., en, es, fr)
unitsstringautoUnit system for weather/calculations: metric, imperial. Defaults based on country — imperial for US, metric for all others.

​
Date filtering

ParameterTypeDescription
dateRangestringRelative range: day, week, month, year, 24h, 7d, 30d, 90d, 1y
dateFromdateResults published on or after this date (YYYY-MM-DD)
dateTodateResults published on or before this date (YYYY-MM-DD)
Use either dateRange for relative filtering or dateFrom/dateTo for absolute date ranges. See filtering for details. 
# Results from the past week
curl "https://search-api.andisearch.com/api/v1/search?q=AI+news&dateRange=week" \
  -H "x-api-key: YOUR_API_KEY"

​
Domain filtering

ParameterTypeDescription
includeDomainsstringComma-separated domains to restrict results to
excludeDomainsstringComma-separated domains to exclude from results
Both support wildcards: *.example.com matches all subdomains. See filtering for details. 
# Search only on specific sites
curl "https://search-api.andisearch.com/api/v1/search?q=python+tutorials&includeDomains=docs.python.org,realpython.com" \
  -H "x-api-key: YOUR_API_KEY"

​
Term filtering

ParameterTypeDescription
includeTermsstringComma-separated terms that must appear in results
excludeTermsstringComma-separated terms to exclude from results

​
Content filtering

ParameterTypeDescription
filetypestringFile extension to filter by (e.g., pdf, doc)
intitlestringTerm that must appear in the page title
inurlstringTerm that must appear in the page URL
intextstringTerm that must appear in the page body

​
Behavior parameters

ParameterTypeDefaultDescription
noCachebooleanfalseBypass cached results
parseOperatorsbooleantrueParse query operators from the query string
linkFormatstringlinkField name for result URLs: link (default) or url

​
Examples

# First page
curl "https://search-api.andisearch.com/api/v1/search?q=machine+learning&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

# Second page
curl "https://search-api.andisearch.com/api/v1/search?q=machine+learning&limit=10&offset=10" \
  -H "x-api-key: YOUR_API_KEY"

​
Deep search with extracts

curl "https://search-api.andisearch.com/api/v1/search?q=climate+change+effects&depth=deep&extracts=true" \
  -H "x-api-key: YOUR_API_KEY"

​
Filtered by date and domain

curl "https://search-api.andisearch.com/api/v1/search?q=product+launch&dateRange=month&includeDomains=techcrunch.com,theverge.com" \
  -H "x-api-key: YOUR_API_KEY"

curl -G "https://search-api.andisearch.com/api/v1/search" \
  --data-urlencode 'q=["artificial intelligence", "machine learning"]' \
  -H "x-api-key: YOUR_API_KEY"
Multi-query search accepts a JSON array of up to 5 queries and returns combined results in a single response. URL-encode the JSON array when passing it as a query parameter.

​
Next steps

Filtering

Domain, date, and content filtering in depth.

Query operators

In-query operators like site: and filetype:.

Basic search example

Complete integration with error handling.

Response format

Response structure and result types.