Felo API PlatformFelo API Platform

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.

Parameters

No path, query, or header parameters.

Request body

  • location_namestringOptional

    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_codeintegerOptional

    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_coordinatestringOptional

    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[]Optional

    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

  • bidnumberOptional

    desired bid setting value in USD maximum value: 1000

  • daily_budgetnumberOptional

    daily campaign budget value in USD maximum value: 10000

  • genderstring[]Optional

    gender to target possible values: male, female, unknown

  • industryinteger[]Optional

    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[]Optional

    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

Example request

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
  ]
}'

Response

Response fields

  • versionstringOptional

    the current version of the API

  • status_codeintegerOptional

    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_messagestringOptional

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

  • timestringOptional

    execution time, seconds

  • costnumberOptional

    total tasks cost, USD

  • tasks_countintegerOptional

    the number of tasks in the tasks array

  • tasks_errorintegerOptional

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

  • tasksstring[]Optional

    array of tasks

  • idstringOptional

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

  • status_codeintegerOptional

    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_messagestringOptional

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

  • timestringOptional

    execution time, seconds

  • costnumberOptional

    cost of the task, USD

  • result_countintegerOptional

    number of elements in the result array

  • pathstring[]Optional

    URL path

  • dataobjectOptional

    contains the same parameters that you specified in the POST request

  • resultstring[]Optional

    array of results

  • est_impressionsobjectOptional

    monthly estimated impressions range

  • highintegerOptional

    indicates the upper bound of the range result

  • lowintegerOptional

    indicates the lower bound of the range result

  • est_audience_sizeobjectOptional

    monthly estimated reach user count range

  • highintegerOptional

    indicates the upper bound of the range result

  • lowintegerOptional

    indicates the lower bound of the range result

  • est_clicksobjectOptional

    monthly estimated click count range

  • highintegerOptional

    indicates the upper bound of the range result

  • lowintegerOptional

    indicates the lower bound of the range result

  • est_spendobjectOptional

    monthly estimated spending range

  • highintegerOptional

    indicates the upper bound of the range result

  • lowintegerOptional

    indicates the lower bound of the range result

  • est_cost_per_eventobjectOptional

    indicates the estimated cost per event with range result

  • highnumberOptional

    indicates the upper bound of the range result

  • lownumberOptional

    indicates the lower bound of the range result

  • est_ctrobjectOptional

    estimated click-through rate range

  • highnumberOptional

    indicates the upper bound of the range result

  • lownumberOptional

    indicates the lower bound of the range result

  • suggested_bidnumberOptional

    suggested bid value under the current targeting

  • suggested_budgetintegerOptional

    suggested daily budget value under the current targeting and bid

  • events_lost_to_bidintegerOptional

    indicates event lost count due to insufficient input bid

  • events_lost_to_budgetintegerOptional

    indicates the event lost count due to insufficient input budget

  • est_reach_audience_sizeintegerOptional

    monthly estimated user count

  • est_reach_impressionsintegerOptional

    monthly estimated impressions

  • currencyintegerOptional

    currency name example: USDollar