DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Setting ‘Bing Ads Audience Estimation’ Tasks
Queues a Bing audience estimation, returning a task id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Retrieve with get_dataforseo_keywords_bing_audience_fetch.
- 型: array object[]
- location型: string
_name 必須full name of search engine location required field if you don’t specify location_code or location_coordinate if you use this field, you don’t need to specify location_code or location_coordinate you can receive the list of available locations of the search engine with their location_name by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations example: London,England,United Kingdom
- age型: array string[]
selection of age ranges for targeting possible values: eighteen_to_twenty_four, fifty_to_sixty_four, sixty_five_and_above, thirteen_to_seventeen, thirty_five_to_forty_nine, twenty_five_to_thirty_four, unknown, zero_to_twelve
- bid型: number
desired bid setting value in USD maximum value: 1000
- daily型: number
_budget daily campaign budget value in USD maximum value: 10000
- gender型: array string[]
gender to target possible values: male, female, unknown
- industry型: array integer[]
industry of LinkedIn profile targeting if you use this field, you can receive the list of available industry names with industry_id by making a separate request to the https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries example: 806301758
- job型: array integer[]
_function job function of LinkedIn profile targeting if you use this field, you can receive the list of available job function names with job_function_id by making a separate request to the https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions example: 806300451
- location型: integer
_code search engine location code required field if you don’t specify location_name or location_coordinate if you use this field, you don’t need to specify location_name or location_coordinate you can receive the list of available locations of the search engines with their location_code by making a separate request to https://api.dataforseo.com/v3/keywords_data/bing/locations example: 2840
- location型: string
_coordinate GPS coordinates of a location required field if you don’t specify location_name or location_code if you use this field, you don’t need to specify location_name or location_code location_coordinate parameter should be specified in the “latitude,longitude,radius (in km)” format the data will be provided for the country the specified coordinates belong to example: 29.6821525,-82.4098881,100
- 型: object200
Successful response
- 型: numbercost
total tasks cost, USD
- 型: integerstatus
_code general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions
- 型: stringstatus
_message general informational message you can find the full list of general informational messages here
- 型: array string[]tasks
array of tasks
- 型: integertasks
_count the number of tasks in the tasksarray
- 型: integertasks
_error the number of tasks in the tasks array returned with an error
- 型: numbertasks
.cost cost of the task, USD
- 型: objecttasks
.data contains the same parameters that you specified in the POST request
- 型: stringtasks
.id unique task identifier in our system unique task identifier in the UUID format
- 型: array string[]tasks
.path URL path
- 型: array string[]tasks
.result array of results in this case, the value will be null
- 型: integertasks
.result _count number of elements in the result array
- 型: integertasks
.status _code status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of response codes here
- 型: stringtasks
.status _message informational message of the task you can find the full list of general informational messages here
- 型: stringtasks
.time execution time, seconds
- 型: stringtime
execution time, seconds
- 型: stringversion
the current version of the API
application/json - 400
Bad request
- 401
Unauthorized
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
Rate limit exceeded
- 500
Internal server error
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/audience_estimation/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks.id": "string",
"tasks.status_code": 1,
"tasks.status_message": "string",
"tasks.time": "string",
"tasks.cost": 1,
"tasks.result_count": 1,
"tasks.path": [
"string"
],
"tasks.data": {},
"tasks.result": [
"string"
]
}