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

Authentification

ApiKeyAuth

headerx-api-key<token>

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

Paramètres de requête

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.

Corps de la réponse

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"    ]  }}

AuthentificationCopier le lien de l'ancre

Paramètres de requêteCopier le lien de l'ancre

Corps de la réponseCopier le lien de l'ancre

Authentification

Paramètres de requête

Corps de la réponse