Search

GET

/v1/search

One call walks engines in order and returns the first organic results. engines=auto tries Google, then Brave, Bing, DuckDuckGo, Yahoo, and Baidu. Omitted gl is us and omitted hl is en. There is no page parameter: the response is always page 1. An empty query returns 400. If every engine misses, the call returns 404. Send header x-api-key. 1 credit on HTTP 200.

Credit cost: 1 credit per call

Autorización

ApiKeyAuth

headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parámetros de consulta

query*string

Search query.

engines?string

Engine order. Default auto tries google, brave, bing, duckduckgo, yahoo, then baidu. A comma-separated list is followed as given. ddg and duck mean duckduckgo. Unknown names are ignored.

Default"auto"

gl?string

Country code. Defaults to us when omitted. For example us, fr, gb, de.

hl?string

Language code. Defaults to en when omitted. For example en, fr, de.

Cuerpo de la respuesta

Successful response

application/json

response

organic_results?array<>

search_parameters?

Example Request

curl -X GET 'https://api.autom.dev/v1/search?query=string'

Example Request

curl -X GET 'https://api.autom.dev/v1/search?query=string'

Example ResponseSchema

{
  "organic_results": [
    {
      "link": "https://openai.com/",
      "title": "OpenAI",
      "domain": "openai.com",
      "snippet": "OpenAI is an AI research and deployment company.",
      "position": 1,
      "displayed_link": "https://openai.com"
    }
  ],
  "search_parameters": {
    "q": "openai",
    "gl": "us",
    "hl": "en",
    "page": 1,
    "engine": "google",
    "engines": [
      "google",
      "brave",
      "bing",
      "duckduckgo",
      "yahoo",
      "baidu"
    ]
  }
}

{  "organic_results": [    {      "link": "https://openai.com/",      "title": "OpenAI",      "domain": "openai.com",      "snippet": "OpenAI is an AI research and deployment company.",      "position": 1,      "displayed_link": "https://openai.com"    }  ],  "search_parameters": {    "q": "openai",    "gl": "us",    "hl": "en",    "page": 1,    "engine": "google",    "engines": [      "google",      "brave",      "bing",      "duckduckgo",      "yahoo",      "baidu"    ]  }}

AutorizaciónCopiar enlace del ancla

Parámetros de consultaCopiar enlace del ancla

Cuerpo de la respuestaCopiar enlace del ancla

Autorización

Parámetros de consulta

Cuerpo de la respuesta