Custom Search

Warning

On October 30, 2020, the Bing Search APIs moved from Azure AI services to Bing Search Services. This documentation is provided for reference only. For updated documentation, see the Bing search API documentation. For instructions on creating new Azure resources for Bing search, see Create a Bing Search resource through the Azure Marketplace.

Bing Custom Search enables you to create tailored search experiences for topics that you care about. Your users see search results tailored to the content they care about instead of having to page through search results that have irrelevant content.

Custom Search Endpoint

To get results using the Bing Custom Search API, send a GET request to the following endpoint. Use the headers and URL parameters to define further specifications.

Endpoint: Returns search suggestions as JSON results that are relevant to the user's input defined by ?q="".

 GET https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/search  

For examples that describe how to set up Custom Search sources, see the tutorial. For details about headers, parameters, market codes, response objects, errors, etc., see the Bing Custom Search API v7 reference.

Custom Search Response JSON

A custom search request returns results as JSON objects, see Response objects.

Custom Autosuggest

The Custom Autosuggest API lets you send a partial search query term to Bing and get back a list of suggested queries that you can configure. With Custom Autosuggest, you add suggestions returned by the API and optionally specify whether to include suggestions generated by Bing.

Custom Autosuggest Endpoint

To request custom query suggestions, send a GET request to:

https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/Suggestions

For information about defining custom suggestions, see Define custom search suggestions.

The Custom Image Search API lets you send a search query to Bing and get back a list of relevant images from your Custom Search instance.

Custom Image Search Endpoint

To request images from your Custom Search instance, send a GET request to the following URL:

https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/images/search

For information about configuring a Custom Search instance, see Configure your custom search experience.

Next steps

The Bing APIs support search actions that return results according to their type. All search endpoints return results as JSON response objects.  All endpoints support queries that return a specific language and/or location by longitude, latitude, and search radius.

For complete information about the parameters supported by each endpoint, see the reference pages for each type. For examples of basic requests using the Custom Search API, see Custom Search Quick-starts