v0.2.0-beta

OpenAPI 3.1.0

Налаштування live-завдань «Оцінка аудиторії Bing Ads»

Felo API Support

MIT

Сервер

https://openapi.felo.ai

Клієнтські бібліотеки

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операції

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

Налаштування live-завдань «Оцінка аудиторії Bing Ads»

Оцінює аудиторію Bing Ads, досяжну за заданих bid і daily_budget, зі звуженням за location_code, age, галуззю та посадовою функцією. Відповідь обгорнуто в конверт DataForSEO: дані в tasks[0].result, результат у tasks[0].status_code — відхилений запит усе одно повертає HTTP 200. Значення галузей і посадових функцій беруться з get_dataforseo_keywords_bing_audience_industries і get_dataforseo_keywords_bing_audience_job_functions — обидва безкоштовні, і обидва варто прочитати перед складанням запиту. Парні ендпоінти submit і fetch виконують ту саму роботу асинхронно й за тією самою ціною — для пакетів, які надто великі, щоб чекати на їх завершення.

Довідкова інформація про ціни

Тарифікація: заявлена вартість відповіді.
Довідкова оцінка запиту: USD 0.09.
Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Лише довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

Тіло

application/json

Тип: array (object | null)[]
- age
  Тип: array string[] | null
  
  вибір вікових діапазонів для таргетингу
  можливі значення: 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 | null
  
  бажане значення ставки в USD
  максимальне значення: 1000
- daily_budget
  Тип: number | null
  
  значення денного бюджету кампанії в USD
  максимальне значення: 10000
- gender
  Тип: array string[] | null
  
  стать для таргетингу
  можливі значення: male, female, unknown
- industry
  Тип: array string[] | null
  
  галузь таргетингу за профілем LinkedIn
  
  якщо використовувати це поле, список доступних назв галузей з industry_id можна отримати окремим запитом до https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries
  
  приклад: 806301758
- job_function
  Тип: array string[] | null
  
  посада таргетингу за профілем LinkedIn
  
  якщо використовувати це поле, список доступних назв посад з job_function_id можна отримати окремим запитом до https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions
  
  приклад: 806300451
- location_code
  Тип: integer
  
  код місцеположення пошукової системи
  обов'язкове поле, якщо не вказано location_name або location_coordinate
  якщо використовуєте це поле, location_name або location_coordinate вказувати не потрібно
  список доступних місцеположень пошукових систем з їхнім location_code можна отримати окремим запитом до https://api.dataforseo.com/v3/keywords_data/bing/locations
  приклад:
  2840
- location_coordinate
  Тип: string
  
  GPS-координати місцеположення
  обов'язкове поле, якщо не вказано location_name або location_code
  якщо використовуєте це поле, location_name або location_code вказувати не потрібно
  параметр location_coordinate вказується у форматі "широта,довгота,радіус (у км)"
  дані буде надано для країни, до якої належать вказані координати
  приклад:
  29.6821525,-82.4098881,100
- location_name
  Тип: string
  
  повна назва місцеположення пошукової системи
  обов'язкове поле, якщо не вказано location_code або location_coordinate
  якщо використовуєте це поле, location_code або location_coordinate вказувати не потрібно
  список доступних місцеположень пошукової системи з їхньою location_name можна отримати окремим запитом до https://api.dataforseo.com/v3/keywords_data/bing/locations
  приклад:
  London,England,United Kingdom

Відповіді

200
Тип: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

status_code
Тип: integer | null

загальний код стану. Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

tasks
Тип: array (object | null)[] | null

масив завдань

Тип: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
cost
Тип: number | null Формат: double

загальна вартість завдань, USD

data
Тип: object | null

містить ті самі параметри, які ви вказали в POST-запиті

propertyName
Тип: object | null
id
Тип: string | null

ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

path
Тип: array (string | null)[] | null

шлях URL

result
Тип: array (object | null)[] | null

масив результатів

currency
Тип: string | null

назва валюти

приклад: USDollar

est_audience_size
Тип: object | null · Response36Afe1097B20_AudienceEstimationInfo

діапазон орієнтовного місячного охоплення користувачів

high
Тип: number | null Формат: double

указує верхню межу результату діапазону

low
Тип: number | null Формат: double

указує нижню межу результату діапазону

est_clicks
Тип: object | null · Response36Afe1097B20_AudienceEstimationInfo

діапазон орієнтовної місячної кількості кліків

high
Тип: number | null Формат: double

указує верхню межу результату діапазону

low
Тип: number | null Формат: double

указує нижню межу результату діапазону

est_cost_per_event
Тип: object | null · Response36Afe1097B20_AudienceEstimationInfo

орієнтовна вартість за подію у вигляді діапазону

high
Тип: number | null Формат: double

указує верхню межу результату діапазону

low
Тип: number | null Формат: double

указує нижню межу результату діапазону

est_ctr
Тип: object | null · Response36Afe1097B20_AudienceEstimationInfo

діапазон орієнтовної клікабельності

high
Тип: number | null Формат: double

указує верхню межу результату діапазону

low
Тип: number | null Формат: double

указує нижню межу результату діапазону

est_impressions
Тип: object | null · Response36Afe1097B20_AudienceEstimationInfo

діапазон орієнтовних місячних показів

high
Тип: number | null Формат: double

указує верхню межу результату діапазону

low
Тип: number | null Формат: double

указує нижню межу результату діапазону

est_reach_audience_size
Тип: integer | null Формат: int64

орієнтовна місячна кількість користувачів

est_reach_impressions
Тип: integer | null Формат: int64

орієнтовна місячна кількість показів

est_spend
Тип: object | null · Response36Afe1097B20_AudienceEstimationInfo

діапазон орієнтовних місячних витрат

high
Тип: number | null Формат: double

указує верхню межу результату діапазону

low
Тип: number | null Формат: double

указує нижню межу результату діапазону

events_lost_to_bid
Тип: integer | null Формат: int64

кількість втрачених подій через недостатню вхідну ставку

events_lost_to_budget
Тип: integer | null

кількість втрачених подій через недостатній вхідний бюджет

suggested_bid
Тип: number | null

рекомендоване значення ставки за поточного таргетингу

suggested_budget
Тип: number | null Формат: double

рекомендоване значення денного бюджету за поточного таргетингу та ставки

result_count
Тип: integer | null Формат: int64

кількість елементів у масиві result

status_code
Тип: integer | null

код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

status_message
Тип: string | null

інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

time
Тип: string | null

час виконання, секунди

tasks_count
Тип: integer | null Формат: int64

кількість завдань у масиві tasks

tasks_error
Тип: integer | null Формат: int64

кількість завдань у масиві tasks, повернутих з помилкою

time
Тип: string | null

загальний час виконання, секунди

version
Тип: string | null

поточна версія API
application/json
400

Не вдалося обробити запит. Перевірте параметри запиту.
401

Потрібен дійсний API-ключ Felo.
402

Запит неможливо виконати: умови білінгу не виконано.
403

Обліковий запис не має дозволу на цю операцію.
429

Досягнуто ліміту запитів або витрат.
502

Служба не змогла виконати запит.
503

API або служба білінгу тимчасово недоступні.
504

Час очікування обробки запиту вичерпано.
default

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

application/json

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_coordinate": "29.6821525,-82.4098881,100",
    "age": [
      "twenty_five_to_thirty_four",
      "eighteen_to_twenty_four",
      "unknown"
    ],
    "bid": 1,
    "daily_budget": 24,
    "gender": [
      "male"
    ],
    "industry": [
      "806303407",
      "806301758"
    ],
    "job_function": [
      "806298607"
    ]
  }
]'

Показати схему

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "est_impressions": {
            "high": null,
            "low": null
          },
          "est_audience_size": {
            "high": null,
            "low": null
          },
          "est_clicks": {
            "high": null,
            "low": null
          },
          "est_spend": {
            "high": null,
            "low": null
          },
          "est_cost_per_event": {
            "high": null,
            "low": null
          },
          "est_ctr": {
            "high": null,
            "low": null
          },
          "suggested_bid": null,
          "suggested_budget": null,
          "events_lost_to_bid": null,
          "events_lost_to_budget": null,
          "est_reach_audience_size": null,
          "est_reach_impressions": null,
          "currency": null
        }
      ]
    }
  ]
}

Успішна операція

Налаштування live-завдань «Оцінка аудиторії Bing Ads»

АвтентифікаціяRequired

DataForSEO

Налаштування live-завдань «Оцінка аудиторії Bing Ads»

Довідкова інформація про ціни