데이터 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