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
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringSearch query.
engines?stringEngine 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.
"auto"gl?stringCountry code. Defaults to us when omitted. For example us, fr, gb, de.
hl?stringLanguage code. Defaults to en when omitted. For example en, fr, de.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
organic_results?array<>search_parameters?curl -X GET 'https://api.autom.dev/v1/search?query=string'{ "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" ] }}