Bing Organic SERP POST

Bing SERP API provides top 100 search engine results. These results are specific to the selected location and language settings. This is the Standard method of data retrieval. It requires making separate POST and GET requests. Using this method, you can retrieve the results after our system collects them.

curl --location --request POST 'https://api.dataforseo.com/v3/serp/bing/organic/task_post' \ --header 'Content-Type: application/json' \ --header 'Authorization: Basic Og==' \ --data-raw '[ { "location_name": "united states", "language_name": "english", "keyword": "albert einstein" } ]'

{ "version": "0.1.20241227", "status_code": 20000, "status_message": "Ok.", "time": "0.1866 sec.", "cost": 0.0006, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "04021320-8029-0066-0000-d9c994374ee6", "status_code": 20100, "status_message": "Task Created.", "time": "0.0151 sec.", "cost": 0.0006, "result_count": 0, "path": [ "v3", "serp", "bing", "organic", "task_post" ], "data": { "api": "serp", "function": "task_post", "se": "bing", "se_type": "organic", "location_name": "united states", "language_name": "english", "keyword": "albert einstein", "device": "desktop", "os": "windows" }, "result": null } ] }

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

array of:

keyword

string

required

All %## will be decoded (plus character ‘+’ will be decoded to a space character). If you need to use the “%” character for your keyword, please specify it as “%25”. If you need to use the “+” character for your keyword, please specify it as “%2B”.

<= 700 characters

location_name

string

required

Full name of search engine location. You can find the supported locations in the DataForSEO documentation.

language_name

string

required

Full name of search engine language. You can find the supported languages in the DataForSEO documentation.

url

string

optional

Direct URL of the search query. You can specify a direct URL and we will sort it out to the necessary fields.

priority

enum<integer>

optional

Task priority.

Allowed values:

Default:

device

enum<string>

optional

Device type.

Allowed values:

desktopmobile

Default:

desktop

enum<string>

optional

Device operating system.

Allowed values:

windowsmacosandroidios

depth

integer

optional

Parsing depth. Number of results in SERP.

<= 700

Default:

100

max_crawl_pages

integer

optional

Page crawl limit. Number of search results pages to crawl.

<= 100

calculate_rectangles

boolean

optional

Calcualte pixel rankings for SERP elements in advanced results.

Default:

false

browser_screen_width

integer

optional

Browser screen width. You can set a custom browser screen width to calculate pixel rankings for a particular device.

browser_screen_height

integer

optional

Browser screen height. You can set a custom browser screen height to calculate pixel rankings for a particular device.

browser_screen_resolution_ratio

integer

optional

Browser screen resolution ratio. You can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device.

search_param

string

optional

Additional parameters of the search query. You can find the list of available parameters and additional details here.

tag

string

optional

User-defined task identifier. You can use this parameter to identify the task and match it with the result.

postback_url

string

optional

Return URL for sending task results.

postback_data

enum<string>

optional

Postback_url datatype. Required field if you specify postback_url.

Allowed values:

regularadvancedhtml

pingback_url

string

optional

Notification URL of a completed task. When a task is completed we will notify you by GET request sent to the URL you have specified.

Examples

Request

Responses