Bing Maps API documentation for developers who need local business results from Bing Maps as JSON. Scrappa's GET /api/bing/maps endpoint returns places with address, phone, website, category, coordinates, rating and opening status.
How to call the endpoint
Send a GET request with a required query that includes the place, for example pizza berlin, and your API key in the x-api-key header. Limit the count with limit (1-10). The endpoint has no page parameter because Bing's local results do not page reliably. A query that is not a local search returns an empty list.
Response fields
Each place has position, id, name, category, address, phone, website, latitude, longitude, rating, review_count, rating_source, open_status, open_hours and image. Fields Bing does not show for a place are null.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
5 optional filters available.
string
Required
Local business search with the city in the text.
Example: pizza berlin
coffee shops
string
Optional
Alias for query. Prefer query for new integrations.
coffee shops
string
Optional
Maximum number of places.
Range: 1-10
Default: 10
10
string
Optional
Bing market, language and region together, for example de-DE or en-GB. Results, wording and dates follow the market.
Default: en-US
example
string
Optional
Two-letter country code, for example DE. Scrappa sends it together with mkt.
Default: the country of mkt
example
string
Optional
Interface language, for example de. Scrappa sends it together with mkt.
Default: the language of mkt
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
limit
query
market
source
results_on_page
Common data fields
id
name
image
phone
{
"data": [
{
"id": "ypid:YN47CA1C40C77636B6",
"name": "Standard Serious Pizza",
"image": "https://www.bing.com/th?id=OLC.4shfBA9pMSWG6g480x360&pid=Local",
"phone": "030 48625614",
"rating": 4,
"address": "Templiner Stra\u00dfe 7 Berlin",
"website": "https://www.standard-berlin.de/",
"category": "Pizza restaurant",
"latitude": 52.532867,
"position": 1,
"longitude": 13.408627,
"open_hours": "Open until 12 AM tomorrow",
"open_status": "Open",
"review_count": 395,
"rating_source": "Tripadvisor"
}
],
"limit": 10,
"query": "pizza berlin",
"market": {
"cc": "US",
"mkt": "en-US",
"setlang": "en"
},
"source": "bing",
"results_on_page": 1
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
The query is missing, limit is outside 1-10, page was sent (not supported), or mkt, cc or setlang is malformed.
{
"errors": {
"query": [
"The query field is required."
]
},
"message": "The request validation failed"
}Bing Temporarily Unavailable
Bing did not return usable data after the bounded retry on a second route. The request is not billed. Retry shortly.
{
"error": "Bing upstream is temporarily unavailable. Please retry shortly.",
"service": "BingVerticalsService",
"retryable": true,
"error_code": "bing_upstream_unavailable",
"failed_stage": "upstream_request"
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.