Autom

Bing Search

GET
/v1/bing/search

Query Bing Search via API and retrieve structured organic results (title, link, snippet, position).

Credit cost: 1 credit per call

Autorização

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

The search query you want to run on Bing.

page?number

Page number for pagination (1 = first page).

Default"1"
num?number

Number of results per page (e.g. 10, 20, 50). This value is a suggestion.

Default"10"
location?string

Search origin location (e.g. city).

lat?number

GPS latitude for the search origin.

lon?number

GPS longitude for the search origin.

mkt?string

Market code where results come from (e.g. en-US). Cannot be used together with cc.

cc?string

Country code to search from (2-letter ISO 3166-1). Cannot be used together with mkt.

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

Corpo da resposta

Successful response

application/json
  1. response
pagination?
organic_results?array<>
search_parameters?
Example Request
curl -X GET 'https://api.autom.dev/v1/bing/search?query=string'
Example Response
{  "pagination": {    "next": 2,    "current": 1,    "has_next_page": true  },  "organic_results": [    {      "link": "https://openai.com/",      "title": "OpenAI",      "domain": "openai.com",      "snippet": "OpenAI is an AI research and deployment company.",      "position": 1    }  ],  "search_parameters": {    "q": "openai",    "cc": "us",    "mkt": "en-US",    "page": 1,    "engine": "bing"  }}