What is the Bing Custom Search API?


On October 30, 2020, the Bing Search APIs moved from Cognitive 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.

The Bing Custom Search API enables you to create tailored ad-free search experiences for topics that you care about. You can specify the domains and webpages for Bing to search, as well as pin, boost, or demote specific content to create a custom view of the web and help your users quickly find relevant search results.


Feature Description
Custom real-time search suggestions Provide search suggestions that can be displayed as a dropdown list as your users type.
Custom image search experiences Enable your users to search for images from the domains and websites specified in your custom search instance.
Custom video search experiences Enable your users to search for videos from the domains and sites specified in your custom search instance.
Share your custom search instance Collaboratively edit and test your search instance by sharing it with members of your team.
Configure a UI for your applications and websites Provides a hosted UI that you can easily integrate into your webpages and web applications as a JavaScript code snippet.


You can create a customized search instance by using the Bing Custom Search portal. The portal enables you to create a custom search instance that specifies the domains, websites, and webpages that you want Bing to search, along with the ones that you don’t want it to search. You can also use the portal to: preview the search experience, adjust the search rankings that the API provides, and optionally configure a searchable user interface to be rendered in your websites and applications.

After creating your search instance, you can integrate it (and optionally, a user interface) into your website or application by calling the Bing Custom Search API:

Image showing that you can connect to Bing custom search via the API

Next steps

To get started quickly, see Create your first Bing Custom Search instance.

For details about customizing your search instance, see Define a custom search instance.

Be sure to read Bing Use and Display Requirements for using search results in your services and applications.

Visit the Bing Search API hub page to explore the other available APIs.

Familiarize yourself with the reference content for each of the custom search endpoints. The reference contains the endpoints, headers, and query parameters that you'd use to request search results. It also includes definitions of the response objects.


Because URL formats and parameters are subject to change without notice, use all URLs as-is. You should not take dependencies on the URL format or parameters except where noted.