Skip to main content
POST
Setting Bing Organic SERP Tasks
Queues the ranked results for a keyword on Bing, returning a task id in tasks[0].id. The charge lands here; fetching is free, including re-fetching. 💰 Measured at 0.002upstreamagainstthe0.002 upstream against the 0.012 billed - this family is the cheapest source of search data here, six times under the flat rate. Wrapped in DataForSEO’s envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
keyword
string
required

Keyword to search for

location_name
string

Full name of search engine location

location_code
integer

Search engine location code

language_name
string

Full name of search engine language

language_code
string

Search engine language code

device
string

Device type

os
string

Device operating system

depth
integer

Parsing depth

priority
integer

Task priority

postback_url
string

URL for sending task results

pingback_url
string

Notification URL of a completed task

postback_data
string

Postback datatype; possible values: regular, advanced, html

Response

Successful response

version
string

The current version of the API

status_code
integer

General status code

status_message
string

General informational message

time
string

Execution time, seconds

cost
number

Total tasks cost, USD

tasks_count
integer

The number of tasks in the tasks array

tasks_error
integer

The number of tasks in the tasks array returned with an error

tasks
string[]

Array of task objects

tasks[].id
string

Task identifier in UUID format

tasks[].status_code
integer

Task status code

tasks[].status_message
string

Task status message

tasks[].cost
number

Cost of the task, USD

tasks[].result_count
integer

Number of elements in the result array