Custom Web Search API v7 reference

The Web Search API lets you send a search query to Bing and get back web pages from the slice of Web that your Custom Search instance defines. This section provides technical details about the query parameters and headers that you use to request web results and the JSON response objects that contain them. For information about configuring a Custom Search instance, see Configure your custom search experience.

For information about permitted use and display of the results, see Use and display requirements.


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.


To request search results from your custom instance, send a GET request to:

Endpoint Service Custom Web Search Custom Autosuggest Custom Image Search Custom Video Search

The request must use the HTTPS protocol.


The maximum URL length is 2,048 characters. To ensure that your URL length does not exceed the limit, the maximum length of your query parameters should be less than 1,500 characters. If the URL exceeds 2,048 characters, the server returns 404 Not found.

Next steps

Check out the following programming elements you'll use when sending search requests: