Data API / DataForSEO / Keywords Data

Setting Live ‘Bing Ads Audience Estimation’ Tasks

Estimates the Bing Ads audience reachable at a given bid and daily_budget, narrowed by location_code, age, industry and job function. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Industry and job-function values come from get_dataforseo_keywords_bing_audience_industries and get_dataforseo_keywords_bing_audience_job_functions - both free, and both worth reading before composing a request. The submit and fetch twins of this endpoint do the same work asynchronously, at the same price, for batches too large to wait on.

Параметры

Параметров пути, запроса и заголовков нет.

Тело запроса

location_namestringНеобязательный
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_codeintegerНеобязательный
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_coordinatestringНеобязательный
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
agestring[]Необязательный
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
bidnumberНеобязательный
desired bid setting value in USD maximum value: 1000
daily_budgetnumberНеобязательный
daily campaign budget value in USD maximum value: 10000
genderstring[]Необязательный
gender to target possible values: male, female, unknown
industryinteger[]Необязательный
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_functioninteger[]Необязательный
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

Пример запроса

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "location_name": "<string>",
  "location_code": 0,
  "location_coordinate": "<string>",
  "age": [
    "<string>"
  ],
  "bid": 0,
  "daily_budget": 0,
  "gender": [
    "<string>"
  ],
  "industry": [
    0
  ]
}'

Ответ

Поля ответа

versionstringНеобязательный
the current version of the API
status_codeintegerНеобязательный
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_messagestringНеобязательный
general informational message you can find the full list of general informational messages here
timestringНеобязательный
execution time, seconds
costnumberНеобязательный
total tasks cost, USD
tasks_countintegerНеобязательный
the number of tasks in the tasks array
tasks_errorintegerНеобязательный
the number of tasks in the tasks array returned with an error
tasksstring[]Необязательный
array of tasks
idstringНеобязательный
task identifier unique task identifier in our system in the UUID format
status_codeintegerНеобязательный
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
status_messagestringНеобязательный
informational message of the task you can find the full list of general informational messages here
timestringНеобязательный
execution time, seconds
costnumberНеобязательный
cost of the task, USD
result_countintegerНеобязательный
number of elements in the result array
pathstring[]Необязательный
URL path
dataobjectНеобязательный
contains the same parameters that you specified in the POST request
resultstring[]Необязательный
array of results
est_impressionsobjectНеобязательный
monthly estimated impressions range
highintegerНеобязательный
indicates the upper bound of the range result
lowintegerНеобязательный
indicates the lower bound of the range result
est_audience_sizeobjectНеобязательный
monthly estimated reach user count range
highintegerНеобязательный
indicates the upper bound of the range result
lowintegerНеобязательный
indicates the lower bound of the range result
est_clicksobjectНеобязательный
monthly estimated click count range
highintegerНеобязательный
indicates the upper bound of the range result
lowintegerНеобязательный
indicates the lower bound of the range result
est_spendobjectНеобязательный
monthly estimated spending range
highintegerНеобязательный
indicates the upper bound of the range result
lowintegerНеобязательный
indicates the lower bound of the range result
est_cost_per_eventobjectНеобязательный
indicates the estimated cost per event with range result
highnumberНеобязательный
indicates the upper bound of the range result
lownumberНеобязательный
indicates the lower bound of the range result
est_ctrobjectНеобязательный
estimated click-through rate range
highnumberНеобязательный
indicates the upper bound of the range result
lownumberНеобязательный
indicates the lower bound of the range result
suggested_bidnumberНеобязательный
suggested bid value under the current targeting
suggested_budgetintegerНеобязательный
suggested daily budget value under the current targeting and bid
events_lost_to_bidintegerНеобязательный
indicates event lost count due to insufficient input bid
events_lost_to_budgetintegerНеобязательный
indicates the event lost count due to insufficient input budget
est_reach_audience_sizeintegerНеобязательный
monthly estimated user count
est_reach_impressionsintegerНеобязательный
monthly estimated impressions
currencyintegerНеобязательный
currency name example: USDollar