Core APIs
...
Bing
Core Requests

Search

4min

Bing Search Parameters

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.

Bing Search Results
Bing Search Results


For example, to request Bing search results for the keyword pizza , in the location United States , the request would be:

HTTP
Curl
Node.js
Python
PHP



Bing Search Parameters

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

Updated 22 Aug 2024
Did this page help you?