Skip to main content
POST
https://api.aisa.one/apis/v1
/
dataforseo
/
keywords_data
/
bing
/
audience_estimation
/
live
Setting Live ‘Bing Ads Audience Estimation’ Tasks
curl --request POST \
  --url https://api.aisa.one/apis/v1/dataforseo/keywords_data/bing/audience_estimation/live \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "location_name": "<string>",
  "location_code": 123,
  "location_coordinate": "<string>",
  "age": [
    "<string>"
  ],
  "bid": 123,
  "daily_budget": 123,
  "gender": [
    "<string>"
  ],
  "industry": [
    "<string>"
  ],
  "job_function": [
    "<string>"
  ]
}
'
{
  "version": "<string>",
  "status_code": 123,
  "status_message": "<string>",
  "time": "<string>",
  "cost": 123,
  "tasks_count": 123,
  "tasks_error": 123,
  "tasks": [
    "<string>"
  ],
  "tasks.id": "<string>",
  "tasks.status_code": 123,
  "tasks.status_message": "<string>",
  "tasks.time": "<string>",
  "tasks.cost": 123,
  "tasks.result_count": 123,
  "tasks.path": [
    "<string>"
  ],
  "tasks.data": {},
  "tasks.result": [
    "<string>"
  ],
  "tasks.result.est_impressions": {},
  "tasks.result.est_impressions.high": 123,
  "tasks.result.est_impressions.low": 123,
  "tasks.result.est_audience_size": {},
  "tasks.result.est_audience_size.high": 123,
  "tasks.result.est_audience_size.low": 123,
  "tasks.result.est_clicks": {},
  "tasks.result.est_clicks.high": 123,
  "tasks.result.est_clicks.low": 123,
  "tasks.result.est_spend": {},
  "tasks.result.est_spend.high": 123,
  "tasks.result.est_spend.low": 123,
  "tasks.result.est_cost_per_event": {},
  "tasks.result.est_cost_per_event.high": 123,
  "tasks.result.est_cost_per_event.low": 123,
  "tasks.result.est_ctr": {},
  "tasks.result.est_ctr.high": 123,
  "tasks.result.est_ctr.low": 123,
  "tasks.result.suggested_bid": 123,
  "tasks.result.suggested_budget": 123,
  "tasks.result.events_lost_to_bid": 123,
  "tasks.result.events_lost_to_budget": 123,
  "tasks.result.est_reach_audience_size": 123,
  "tasks.result.est_reach_impressions": 123,
  "tasks.result.currency": 123
}

Documentation Index

Fetch the complete documentation index at: https://aisa.one/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
location_name
string
required

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

​
location_code
integer
required

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_coordinate
string
required

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

​
age
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_budget
number

daily campaign budget value in USD maximum value: 10000

​
gender
string[]

gender to target possible values: male, female, unknown

​
industry
string[]

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_function
string[]

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

Response

Successful response

​
version
string

the current version of the API

​
status_code
integer

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

​
status_message
string

general informational message you can find the full list of general informational messages here

​
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 tasks

​
tasks.id
string

task identifier unique task identifier in our system in the UUID format

​
tasks.status_code
integer

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

​
tasks.status_message
string

informational message of the task you can find the full list of general informational messages here

​
tasks.time
string

execution time, seconds

​
tasks.cost
number

cost of the task, USD

​
tasks.result_count
integer

number of elements in the result array

​
tasks.path
string[]

URL path

​
tasks.data
object

contains the same parameters that you specified in the POST request

​
tasks.result
string[]

array of results

​
tasks.result.est_impressions
object

monthly estimated impressions range

​
tasks.result.est_impressions.high
integer

indicates the upper bound of the range result

​
tasks.result.est_impressions.low
integer

indicates the lower bound of the range result

​
tasks.result.est_audience_size
object

monthly estimated reach user count range

​
tasks.result.est_audience_size.high
integer

indicates the upper bound of the range result

​
tasks.result.est_audience_size.low
integer

indicates the lower bound of the range result

​
tasks.result.est_clicks
object

monthly estimated click count range

​
tasks.result.est_clicks.high
integer

indicates the upper bound of the range result

​
tasks.result.est_clicks.low
integer

indicates the lower bound of the range result

​
tasks.result.est_spend
object

monthly estimated spending range

​
tasks.result.est_spend.high
integer

indicates the upper bound of the range result

​
tasks.result.est_spend.low
integer

indicates the lower bound of the range result

​
tasks.result.est_cost_per_event
object

indicates the estimated cost per event with range result

​
tasks.result.est_cost_per_event.high
number

indicates the upper bound of the range result

​
tasks.result.est_cost_per_event.low
number

indicates the lower bound of the range result

​
tasks.result.est_ctr
object

estimated click-through rate range

​
tasks.result.est_ctr.high
number

indicates the upper bound of the range result

​
tasks.result.est_ctr.low
number

indicates the lower bound of the range result

​
tasks.result.suggested_bid
number

suggested bid value under the current targeting

​
tasks.result.suggested_budget
integer

suggested daily budget value under the current targeting and bid

​
tasks.result.events_lost_to_bid
integer

indicates event lost count due to insufficient input bid

​
tasks.result.events_lost_to_budget
integer

indicates the event lost count due to insufficient input budget

​
tasks.result.est_reach_audience_size
integer

monthly estimated user count

​
tasks.result.est_reach_impressions
integer

monthly estimated impressions

​
tasks.result.currency
integer

currency name example: USDollar