JustSERPDocs
Bing

Bing Maps

The places Bing Maps lists for a query, answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `local_results`, `place_result` (a query with one match: that place is the only `local_results` item) and `pagination`.

GET
/v1/bing/maps

The places Bing Maps lists for a query, answered as the document: search_metadata, search_parameters, search_information (query_displayed), local_results, place_result (a query with one match: that place is the only local_results item) and pagination. Up to 20 places. "Bing Maps couldn't find ..." is local_results: []. place_id is Bing's ypid. filters is passed to Bing but no filters block is answered. Bing Maps lists 60 places at most. zero_retention is not handled.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

A kind of place, a name or an address.

Length1 <= length <= 1000
device?"desktop"

Anything but desktop is a 400.

Default"desktop"
Value in"desktop"
location?string

A place name to centre on. Not with lat and lon.

Lengthlength <= 200
lat?number

With lon: the centre (Bing's cp).

Range-90 <= value <= 90
lon?number

With lat.

Range-180 <= value <= 180
market_code?string

language-country from Bing's list (en-us...). Not with country_code.

country_code?string

Two letters from Bing's list.

Default"US"
language?string

Bing's list.

Default"en"
filters?string

Up to 3 Bing filter values, comma separated (ONow,UR8U).

num?integer

Places a page.

Range3 <= value <= 25
Default20
page?integer

At most floor(60 / num) + 1; first = (page-1)*num.

Range1 <= value <= 21
Default1

Response Body

The places, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The Bing Maps document.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

local_results?array<>

Keys are absent when Bing does not give them.

place_result?

A query with one match.

pagination?
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/bing/maps?q=dentist&location=London&num=10'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {    "query_displayed": "string"  },  "local_results": [    {      "position": 0,      "place_id": "string",      "title": "string",      "link": "string",      "type": "string",      "type_id": "string",      "address": "string",      "phone": "string",      "website": "string",      "rating": 0,      "reviews": 0,      "reviews_source": "string",      "open_state": "string",      "is_permanently_closed": true,      "gps_coordinates": {        "latitude": 0,        "longitude": 0      },      "thumbnail": "string",      "amenities": [        "string"      ]    }  ],  "place_result": {    "title": "string",    "gps_coordinates": {      "latitude": 0,      "longitude": 0    }  },  "pagination": {    "current": 0,    "next": 0  }}

Bing News GET

One page of Bing News stories for a query or a category, answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`, `page`) and `organic_results` (5-12 stories a page).

Bing Images GET

One page of Bing Images results (35 pictures), answered as the document: `search_metadata`, `search_parameters`, `search_information` (`query_displayed`), `suggestions`, `images` and `related_searches`.