Skip to main content
GET
/
api
/
v1
/
search
Search the web
curl --request GET \
  --url https://search-api.andisearch.com/api/v1/search \
  --header 'x-api-key: <api-key>'
{
  "results_type": "<string>",
  "answer": "<string>",
  "type": "<string>",
  "title": "<string>",
  "results": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "type": "website",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extract": "<string>",
      "contentType": "<string>",
      "reader": {}
    }
  ],
  "metrics": {
    "query": "<string>",
    "intent": "<string>",
    "timestamp": "<string>",
    "duration": 123,
    "queries_executed": 123,
    "api_requests_count": 123,
    "results_returned": 123,
    "total_results_found": 123,
    "cached": true
  },
  "correctedQuery": "<string>",
  "related_searches": [
    "<string>"
  ],
  "topics": [
    "<string>"
  ],
  "videos": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "type": "website",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extract": "<string>",
      "contentType": "<string>",
      "reader": {}
    }
  ],
  "images": [
    {
      "title": "<string>",
      "link": "<string>",
      "image": "<string>",
      "source": "<string>",
      "type": "image",
      "t": "<string>",
      "w": "<string>",
      "h": "<string>"
    }
  ],
  "news": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "type": "website",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extract": "<string>",
      "contentType": "<string>",
      "reader": {}
    }
  ],
  "places": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "type": "website",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extract": "<string>",
      "contentType": "<string>",
      "reader": {}
    }
  ],
  "profiles": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "type": "website",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extract": "<string>",
      "contentType": "<string>",
      "reader": {}
    }
  ],
  "socials": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "type": "website",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extract": "<string>",
      "contentType": "<string>",
      "reader": {}
    }
  ],
  "academics": [
    {
      "title": "<string>",
      "link": "<string>",
      "desc": "<string>",
      "source": "<string>",
      "type": "website",
      "date": "<string>",
      "image": "<string>",
      "snippet": "<string>",
      "answer": "<string>",
      "extract": "<string>",
      "contentType": "<string>",
      "reader": {}
    }
  ],
  "weather": {
    "location": {
      "name": "<string>",
      "country": "<string>",
      "coordinates": {
        "latitude": 123,
        "longitude": 123
      }
    },
    "temperature": 123,
    "units": "metric",
    "description": "<string>",
    "feelsLike": 123,
    "humidity": 123,
    "windSpeed": 123,
    "windDirection": 123,
    "pressure": 123,
    "icon": "<string>",
    "cloudiness": 123,
    "visibility": 123,
    "timestamp": "<string>"
  },
  "calculation": {
    "expression": "<string>",
    "result": "<string>"
  }
}

Authorizations

x-api-key
string
header
required

API key from the API Console.

Query Parameters

q
string
required

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"]).

limit
integer
default:10

Maximum number of results to return.

Required range: x >= 1
offset
integer
default:0

Number of results to skip for pagination.

Required range: x >= 0
depth
enum<string>
default:fast

Search depth. fast returns results in ~1 second. deep enables spell correction, enhanced analysis, and more sources in ~2–3 seconds.

Available options:
fast,
deep
intent
string

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.

format
enum<string>
default:json

Response format. json returns a JSON object. context returns results as markdown text, suitable for passing to language models.

Available options:
json,
context
metadata
enum<string>
default:basic

Level of metadata to include. basic includes standard search metrics. full includes extended metadata with content type details and reader data on results.

Available options:
basic,
full
extracts
boolean
default:false

Include text extracts from result pages in the response.

safe
boolean
default:false

Enable safe search filtering. Pass true to filter explicit content.

country
string
default:US

Two-letter ISO 3166-1 country code to localize results.

language
string
default:en

Two-letter ISO 639-1 language code to filter results by language.

units
enum<string>

Unit system for weather and calculation results. Defaults based on the country parameter — imperial for US, metric for all other countries.

Available options:
metric,
imperial
noCache
boolean
default:false

Bypass cached results and fetch fresh data.

dateRange
enum<string>

Relative date range filter for results.

Available options:
day,
week,
month,
year,
24h,
7d,
30d,
90d,
1y
dateFrom
string<date>

Filter results published on or after this date. Format: YYYY-MM-DD.

dateTo
string<date>

Filter results published on or before this date. Format: YYYY-MM-DD.

includeDomains
string

Comma-separated list of domains to restrict results to. Supports wildcards (*.example.com).

excludeDomains
string

Comma-separated list of domains to exclude from results. Supports wildcards.

includeTerms
string

Comma-separated terms that must appear in results.

excludeTerms
string

Comma-separated terms to exclude from results.

parseOperators
boolean
default:true

Parse query operators (like site:, filetype:, intitle:) from the query string. When disabled, the query is treated as literal text.

filetype
string

Filter results by file type.

intitle
string

Filter results to pages with this term in the title.

inurl
string

Filter results to pages with this term in the URL.

intext
string

Filter results to pages with this term in the body text.

Response

Search results

results_type
string
required

The type of search results returned (e.g., search, news, images).

answer
string
required

A generated answer for the query. May be an empty string when no direct answer is available.

type
string
required

Same as results_type. Indicates the category of results.

title
string
required

A title summarizing the search results.

results
object[]
required

Array of search results.

metrics
object
required

Search performance metrics. Always included in the response.

correctedQuery
string

Spell-corrected query. Only present when deep search detects and corrects a misspelling in the original query.

Related search suggestions. Present on some queries.

topics
string[]

Related topics. Present on some queries.

videos
object[]

Video results. Present when the query triggers a video intent.

images
object[]

Image results. Present when the query triggers an image intent.

news
object[]

News results. Present when the query triggers a news intent.

places
object[]

Place/business results. Present for location-related queries.

profiles
object[]

Profile results. Present for people-related queries.

socials
object[]

Social media results. Present for social-related queries.

academics
object[]

Academic results. Present for scholarly queries.

weather
object

Weather data. Present when the query triggers a weather intent.

calculation
object

Calculation result. Present when the query triggers a calculation intent.