Autom

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.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Cuerpo de la respuesta

Successful response

application/json
  1. response
organic_results?array<>
search_parameters?
Example Request
curl -X GET 'https://api.autom.dev/v1/search?query=string'
Example Response
{  "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"    ]  }}