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

Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

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

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

Нужна помощь?

По вопросам API, оплаты и аккаунта пишите в поддержку.
Общайтесь с разработчиками Felo в Discord.
Загляните в наш журнал изменений.
Нужны цены за объём или помощь с закупкой? Связаться с отделом продаж.
Создаёте на LLM? Прочитайте llms.txt.

Настройка live-задач «Оценка аудитории Bing Ads»

АутентификацияRequired

DataForSEO

Настройка live-задач «Оценка аудитории Bing Ads»

Справочная информация о ценах

Нужна помощь?