Logo SearchApi

Bing Maps API

GET   /api/v1/search?engine=bing_maps
OpenAPI Initiative Download OpenAPI Spec

Bing Maps API returns real-time places from Bing Maps in structured JSON. A search for a kind of place, such as coffee in New York, returns local_results with each place's id, category, address, phone number, website, rating, opening status and GPS coordinates. When Bing Maps answers with a single place, such as a landmark, a business or an address, the response carries that place in place_result, with its weekly hours, description, photos and ratings on review sites when Bing Maps has them.

Text in the results, such as categories, opening hours and filter labels, follows language, else market_code.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the query you want to search on Bing Maps, such as a kind of place (coffee), a business name, a landmark or an address. It can be up to 1000 characters long, and fewer with accented or non-Latin characters, such as 388 Chinese, Japanese or Korean characters. When Bing Maps answers with a single place, the response carries place_result instead of local_results.

Localization

  • Name
    market_code
    Required
    Optional
    Description

    Defines the Bing market, which sets the country of the search and the language of text in the results. Format is language-country, like en-us. Check the full list of supported Bing market_code codes. When market_code is set, country_code is ignored.

  • Name
    country_code
    Required
    Optional
    Description

    Defines the country of the search when market_code is not set. Check the full list of supported Bing country_code countries. Defaults to US.

  • Name
    language
    Required
    Optional
    Description

    Defines the language of text in the results, such as categories, opening hours and filter labels. It takes precedence over the language of market_code. Check the full list of supported Bing language languages.

Geographic Location

  • Name
    location
    Required
    Optional
    Description

    Defines the place the map is centered on, like New York,New York,United States. It can be up to 200 characters long. If multiple locations match your input, the most popular one is selected. For exact names, check out the Locations API. It can't be used together with lat and lon. Without location, lat and lon, the map is centered on a major city of the country set by market_code or country_code.

    Note: When nothing matches near the map center, Bing Maps can return places far from it. Compare their gps_coordinates with the center.

  • Name
    lat
    Required
    Optional
    Description

    Defines the latitude of the map center in decimal degrees, from -85 to 85, like 40.7128. It must be used together with lon, and can't be used together with location.

  • Name
    lon
    Required
    Optional
    Description

    Defines the longitude of the map center in decimal degrees, from -180 to 180, like -74.0060. It must be used together with lat, and can't be used together with location.

Filters

  • Name
    filters
    Required
    Optional
    Description

    Applies filters, such as a star rating, opening hours, a hotel class or a cuisine. Pass up to 3 values from the filters field of a previous response, one per filter group, separated by commas, like ONow,UR8U. Values are case-sensitive. Bing Maps offers filters for some kinds of places, such as restaurants and hotels, and ignores a value it doesn't offer for the search.

    Note: Rating filters are approximate: a place's rating from a review site can be slightly below the chosen stars.

Pagination

  • Name
    num
    Required
    Optional
    Description

    Defines the maximum number of results per page, from 3 to 25. Defaults to 20.

  • Name
    page
    Required
    Optional
    Description

    Defines the page of results to return. The last page available is floor(60 / num) + 1, which is page 4 with the default num. Defaults to 1.

    Note: Bing's ranking varies between requests, so a place can appear on more than one page. De-duplicate results on place_id. A page that pagination.next offers can have no more places.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to bing_maps.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=bing_maps&location=New+York%2CNew+York%2CUnited+States&q=coffee
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "bing_maps",
  "q": "coffee",
  "location": "New York,New York,United States"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_ZD40AeqmorqVsyGgkyw25lR8",
    "status": "Success",
    "created_at": "2026-10-22T15:28:01Z",
    "request_time_taken": 1.59,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.59,
    "request_url": "https://www.bing.com/maps/search?q=coffee&cp=40.7127753%7E-74.0059728&lvl=12&cc=US",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_ZD40AeqmorqVsyGgkyw25lR8.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_ZD40AeqmorqVsyGgkyw25lR8"
  },
  "search_parameters": {
    "engine": "bing_maps",
    "q": "coffee",
    "location": "New York,New York,United States",
    "location_used": "New York,New York,United States",
    "country_code": "US"
  },
  "search_information": {
    "query_displayed": "coffee"
  },
  "local_results": [
    {
      "position": 1,
      "place_id": "YNAE84A6BB7A75D266",
      "title": "Hungry Ghost Coffee",
      "link": "https://www.bing.com/maps?ss=ypid.YNAE84A6BB7A75D266&cp=40.715309~-74.007439",
      "type": "Cafe",
      "type_id": "30974",
      "type_path": "30000.30949.30974",
      "address": "165 Church St, New York, NY 10007",
      "website": "http://www.hungryghostcoffee.com/",
      "rating": 3.5,
      "reviews": 55,
      "reviews_source": "Yelp",
      "open_state": "open",
      "hours": "Open · Closes 7 PM",
      "gps_coordinates": {
        "latitude": 40.71530914306641,
        "longitude": -74.00743865966797
      },
      "thumbnail": "https://www.bing.com/th?id=OLC.EHvnQvqid4LpWQ480x360&pid=Local"
    },
    ...
  ],
  "filters": [
    {
      "key": "rating",
      "type": "Rating",
      "options": [
        {
          "text": "2-star and up",
          "value": "UR4U"
        },
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": 2
  }
}

Filters

Filters

Pass an option's value in the filters parameter to apply it, combining up to 3 values, one per filter group, separated by commas. Options applied to the search carry is_selected.

GET
https://www.searchapi.io/api/v1/search?engine=bing_maps&filters=ONow%2CUR8U&location=New+York%2CNew+York%2CUnited+States&q=coffee
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "bing_maps",
  "q": "coffee",
  "location": "New York,New York,United States",
  "filters": "ONow,UR8U"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "filters": [
    {
      "key": "rating",
      "type": "Rating",
      "options": [
        {
          "text": "2-star and up",
          "value": "UR4U"
        },
        {
          "text": "3-star and up",
          "value": "UR6U"
        },
        {
          "text": "4-star and up",
          "value": "UR8U",
          "is_selected": true
        },
        {
          "text": "5-star and up",
          "value": "UR10"
        }
      ]
    },
    {
      "key": "open_time",
      "type": "Hours",
      "options": [
        {
          "text": "Open now",
          "value": "ONow",
          "is_selected": true
        },
        {
          "text": "Open today",
          "value": "OTod"
        },
        {
          "text": "Open 24 hours",
          "value": "O24h"
        },
        {
          "text": "Early risers",
          "value": "OEar"
        },
        {
          "text": "Breakfast",
          "value": "OBrk"
        },
        {
          "text": "Late lunch",
          "value": "OLLu"
        },
        {
          "text": "Late night",
          "value": "OLNi"
        }
      ]
    }
  ]
}

Hotel Results

Hotel Results

Hotels carry their class as Bing Maps shows it in hotel_class, and its number of stars in extracted_hotel_class.

GET
https://www.searchapi.io/api/v1/search?engine=bing_maps&location=London%2CEngland%2CUnited+Kingdom&market_code=en-gb&q=hotels
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "bing_maps",
  "q": "hotels",
  "location": "London,England,United Kingdom",
  "market_code": "en-gb"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "local_results": [
    {
      "position": 1,
      "place_id": "YN38C4C9A5396B0EF6",
      "title": "The Clermont London, Charing Cross",
      "link": "https://www.bing.com/maps?ss=ypid.YN38C4C9A5396B0EF6&cp=51.508404~-0.124729",
      "type": "Hotel",
      "type_id": "30698",
      "type_path": "30000.30646.30698",
      "address": "Strand, London WC2N 5",
      "phone": "020 7523 5052",
      "website": "https://www.theclermont.co.uk/charing-cross?utm_source=bing&utm_medium=organic&utm_campaign=bing_listing_website_click",
      "rating": 4.8,
      "reviews": 8836,
      "reviews_source": "Tripadvisor",
      "gps_coordinates": {
        "latitude": 51.50840377807617,
        "longitude": -0.1247291713953018
      },
      "thumbnail": "https://www.bing.com/th?id=OLC.IxkKXQdVztFm7w480x360&pid=Local",
      "hotel_class": "4-star hotel",
      "extracted_hotel_class": 4,
      "amenities": [
        "Spa",
        "Family-friendly",
        "Fitness centre",
        "Business centre"
      ]
    },
    ...
  ]
}

Place Results

Place Results

Only the first review site in web_reviews carries its link, rating histogram and recent reviews. An address or a city comes back in place_result without a place_id, with its bounds when Bing Maps gives the area's extent.

GET
https://www.searchapi.io/api/v1/search?engine=bing_maps&location=San+Francisco%2CCalifornia%2CUnited+States&q=golden+gate+bridge
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "bing_maps",
  "q": "golden gate bridge",
  "location": "San Francisco,California,United States"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "place_result": {
    "place_id": "YN8F19071CDAE219EC",
    "title": "Golden Gate Bridge",
    "link": "https://www.bing.com/maps?ss=ypid.YN8F19071CDAE219EC&cp=37.819904~-122.478561",
    "type": "Bridge",
    "type_id": "34182",
    "type_path": "30000.34185.34182",
    "address": "Golden Gate Bridge, San Francisco, CA",
    "phone": "(415) 921-5858",
    "website": "https://www.goldengate.org/",
    "rating": 4.7,
    "reviews": 49995,
    "reviews_source": "Tripadvisor",
    "gps_coordinates": {
      "latitude": 37.81990432739258,
      "longitude": -122.4785614013672
    },
    "description": "The Golden Gate Bridge is San Francisco’s most iconic landmark...",
    "amenities": [
      "Free parking",
      ...
    ],
    "web_reviews": [
      {
        "name": "Tripadvisor",
        "rating": 4.7,
        "max_rating": 5,
        "reviews": 49995,
        "link": "https://www.tripadvisor.com/Attraction_Review-g60713-d104675-Reviews-Golden_Gate_Bridge-San_Francisco_California.html?m=17457",
        "reviews_histogram": {
          "1": 6,
          "2": 3,
          "3": 21,
          "4": 87,
          "5": 423
        },
        "review_results": [
          {
            "username": "sanju_222323",
            "rating": 5.0,
            "description": "Every bit as iconic in person as it looks in photos! The Golden Gate Bridge opened in 1937, and that famous orange color (officially called International Orange) was picked so it stays visible even i…",
            "date": "Oct 13, 2026",
            "link": "http://www.tripadvisor.com/ShowUserReviews-g60713-d104675-r1081733454-Golden_Gate_Bridge-San_Francisco_California.html?m=17457"
          },
          ...
        ]
      },
      ...
    ]
  }
}