Search
GET /search?engine=bing
The Bing Search Parameters are applicable when making a request with engine=bing to retrieve Bing search results for a given search term. The search term is specified in the q parameter.
Setting Location for Bing requests The recommended way of setting the location of your Bing request is to use the location parameter. The location parameter can be populated with a full_name value returned by the Locations API.
You may also use either the market_code or country_code parameters to set the location of your request, but the recommended approach is to use the location parameter as this sets all the required prerequisites to achieve a correctly geo-located result.
For example, to request Bing search results for the keyword pizza , in the location United States , the request would be:
The following parameters are available for all search requests made when engine=bing .
Parameter | Required | Description |
---|---|---|
engine | required | Should be set to engine=bing . |
q | required | The keyword you want to use to perform the search. |
location | optional | Determines the geographic location in which the query is executed. You must enter a full_name value from the SerpWow Locations API , for example location=Richmond+County,New+York,United+States (where Richmond+County,New+York,United+States is the full_name as-returned by the Locations API ). Note the location parameter is the recommended way of setting the location of your Bing request. |
market_code | optional | The market_code parameter determines the Bing-defined market to show results from. This is typically the country in which the user is making requests. View the full list of supported Bing market_code values here . Note the market_code parameter cannot be used in combination with the country_code parameter. |
country_code | optional | The country_code parameter determines the country to show results from (if market_code is not specified). View the full list of supported Bing country_code values here . Note it is recommended that the market_code parameter be used instead of country_code . The country_code parameter cannot be used in combination with the market_code parameter. |
bing_language | optional | The bing_language parameter determines the Bing UI language to return results. View the full list of supported bing_language values here . Defaults to en . |
page | optional | Determines the page of results to return, defaults to 1 . |
max_page | optional | Use the max_page parameter to get multiple pages of results in one request. The API will automatically paginate through pages and concatenate the results into one response. See the Pagination docs for more information. |
num | optional | Determines the number of results to show per page. Use in combination with the page parameter to implement pagination. Note num must be set to 50 or less (this is a Bing-imposed limitation of not returning more than 50 results per page). |
include_answer_box | optional | Determines whether to include the answer box (sometimes called the "featured snippet") in the organic_results array and treat it as the first result. This may be desirable if you treat the result Bing displayed in the answer_box as the first organic result. |
safe | optional | Determines whether Safe Search is enabled for the results. Can be set to strict to enable Safe Search, moderate for just images and videos or off to disable Safe Search. |
Next Steps Bing Search Results