JustSERPDocs
Bing

Bing Maps listing

One business' listing on Bing Maps (what Bing Places for Business publishes), by `place_id` (Bing's ypid, `YNB7EDF204457059FB`, with or without `ypid:`) or by a `profile_url` that carries it, in the citation shape.

GET
/v1/bing/maps/place

One business' listing on Bing Maps (what Bing Places for Business publishes), by place_id (Bing's ypid, YNB7EDF204457059FB, with or without ypid:) or by a profile_url that carries it, in the citation shape. claimed says whether the business has claimed the listing; the rating is another site's (Yelp, Tripadvisor...), named in rating.source.

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
place_id?string

Bing's ypid for the listing, YNB7EDF204457059FB in form, with or without ypid: in front. /v1/bing/maps/place/find returns it.

Match^(ypid:)?YN[0-9A-Za-z]{6,30}$
profile_url?string

A bing.com or bingplaces.com address that carries the ypid (ss=ypid.<id>, filters=local_ypid:"<id>", Id=<id>).

country?string

Two letters, any case (us, GB).

Match^[A-Za-z]{2}$

Response Body

The listing.

application/json
  1. response

The first three keys of every parsed 200 (the answer is the document itself, no success/data envelope): what the search was (search_metadata), what it asked (search_parameters), the parser's own search_information ({} when it has none). The engine's blocks follow, at the same level. An engine whose answer is a list puts it under results.

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 {}.

place_results*

One listing, the same shape for every directory. Every key is always present; null means the directory does not give it (never a guess). A list of candidates carries less than a listing asked for by id: each directory's document says what.

Example Request
curl -X GET 'https://api.justserp.com/v1/bing/maps/place?place_id=YNB7EDF204457059FB'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "place_results": {    "source": "apple_maps",    "place_id": "string",    "url": "string",    "name": "string",    "categories": [      "string"    ],    "address": {      "street": "string",      "city": "string",      "region": "string",      "postal_code": "string",      "country": "string",      "country_code": "string",      "formatted": "string"    },    "phone": "string",    "phone_e164": "string",    "website": "string",    "coordinates": {      "latitude": 0,      "longitude": 0    },    "hours": {      "weekly": [        {          "day": "monday",          "open": "string",          "close": "string"        }      ],      "text": [        "string"      ],      "status_text": "string"    },    "status": "open",    "rating": {      "value": 0,      "scale": 0,      "count": 0,      "source": "string"    },    "claimed": true,    "name_match": true,    "claim_url": "string",    "description": "string",    "price": "string",    "amenities": [      "string"    ],    "timezone": "string",    "extra": {}  }}

Apple App Store Top Grossing GET

The top grossing apps of a storefront, from Apple's top-grossing feed, answered as the document: `chart_information` and `top_grossing_apps`.

Find a business on Bing Maps GET

Searches Bing Maps for `business.name` near `location` and answers its listings in Bing's order.