v0.2.0-beta

OpenAPI 3.1.0

Постановка задач органической выдачи Bing

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/serp/bing/organic/task_post

Постановка задач органической выдачи Bing

Ставит в очередь ранжированные результаты по ключевому слову в Bing и возвращает id задачи в tasks[0].id. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. Живой двойник отвечает сразу и проще для одного запроса; ставьте в очередь, когда пакет не укладывается во время вызова инструмента.

Справочные цены

Тарификация: стоимость ответа по данным провайдера.
Справочная оценка запроса: USD 0.02.
Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.

Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

Тело

application/json

Тип: array (object | null)[]
- browser_screen_height
  Тип: integer | null
  
  высота экрана браузера
  
  необязательное поле
  
  можно задать собственную высоту экрана браузера для расчёта пиксельных позиций для конкретного устройства;
  
  можно указать в следующем диапазоне: 240-9999;
  
  по умолчанию параметр установлен в:
  
  1080 для desktop;
  
  640 для mobile на android;
  
  812 для mobile на iOS;
  
  Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true
- browser_screen_resolution_ratio
  Тип: integer | null
  
  коэффициент разрешения экрана браузера
  
  необязательное поле
  
  можно задать собственный коэффициент разрешения экрана браузера для расчёта пиксельных позиций для конкретного устройства;
  
  можно указать в следующем диапазоне: 0.5-3;
  
  по умолчанию параметр установлен в:
  
  1 для desktop;
  
  3 для mobile на android;
  
  3 для mobile на iOS;
  
  Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true
- browser_screen_width
  Тип: integer | null Формат: int64
  
  ширина экрана браузера
  
  необязательное поле
  
  можно задать собственную ширину экрана браузера для расчёта пиксельных позиций для конкретного устройства;
  
  можно указать в следующем диапазоне: 240-9999;
  
  по умолчанию параметр установлен в:
  
  1920 для desktop;
  
  360 для mobile на android;
  
  375 для mobile на iOS;
  
  Примечание: чтобы использовать этот параметр, задайте для calculate_rectangles значение true
- calculate_rectangles
  Тип: boolean | null
  
  расчёт пиксельных позиций для элементов SERP в расширенных результатах
  
  необязательное поле
  
  пиксельная позиция — это расстояние между сниппетом результата и верхним левым углом экрана;
  
  Подробнее в Help Center>>
  
  по умолчанию параметр установлен в false
  
  Примечание: за использование этого параметра дополнительно взимается $0.0006
- depth
  Тип: integer | null
  
  глубина парсинга
  
  необязательное поле
  
  количество результатов в SERP
  
  значение по умолчанию: 10
  
  максимальное значение: 700
  
  Оплата взимается за каждый SERP, содержащий до 10 результатов;
  Установка глубины выше 10 может привести к дополнительным расходам, если поисковая система возвращает более 10 результатов;
  
  Стоимость можно рассчитать на странице Тарифы.
- device
  Тип: string | null
  
  тип устройства
  
  необязательное поле
  
  возвращать результаты для определённого типа устройства
  
  может принимать значения:desktop, mobile
  
  значение по умолчанию: desktop
- keyword
  Тип: string
  
  ключевое слово
  
  обязательное поле
  
  в поле keyword можно указать до 700 символов
  
  все %## декодируются (символ '+' декодируется в пробел)
  
  если в keyword нужен символ "%", укажите его как "%25";
  
  если в keyword нужен символ “+”, укажите его как “%2B”
  
  Подробнее о правилах и ограничениях полей keyword и keywords в API DataForSEO читайте в статье Help Center
- language_code
  Тип: string
  
  код языка поисковой системы
  
  обязательное поле, если не указан language_name
  
  если используете это поле, language_name указывать не нужно
  
  список доступных языков поисковой системы и их language_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  пример:
  
  en
- language_name
  Тип: string
  
  полное название языка поисковой системы
  
  обязательное поле, если не указан language_code
  
  если используете это поле, language_code указывать не нужно
  
  список доступных языков поисковой системы и их language_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
  
  пример:
  
  English
- location_code
  Тип: integer
  
  код местоположения поисковой системы
  
  обязательное поле, если не указаны location_name или location_coordinate
  
  если используете это поле, location_name или location_coordinate указывать не нужно
  
  список доступных местоположений поисковых систем и их location_code можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  пример:
  
  2840
- location_coordinate
  Тип: string
  
  GPS-координаты местоположения
  
  обязательное поле, если не указан location_name или location_code
  
  если используете это поле, location_name или location_code указывать не нужно
  
  параметр location_coordinate указывается в формате "latitude,longitude"
  
  максимальное число десятичных цифр для "latitude" и "longitude": 7
  
  пример:
  
  53.476225,-2.243572
- location_name
  Тип: string
  
  полное название местоположения поисковой системы
  
  обязательное поле, если не указаны location_code или location_coordinate
  
  если используете это поле, location_code или location_coordinate указывать не нужно
  
  список доступных местоположений поисковой системы с их location_name можно получить отдельным запросом к https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
  
  пример:
  
  London,England,United Kingdom
- match_type
  Тип: string
  
  тип соответствия цели
  
  обязательное поле, если указан stop_crawl_on_match
  
  тип соответствия для match_value
  
  возможные значения:
  
  domain – конкретный домен или поддомен
  
  with_subdomains – основной домен и поддомены
  
  wildcard – шаблон с подстановочными символами
- match_value
  Тип: string
  
  целевой домен, поддомен или значение шаблона
  
  обязательное поле, если указан stop_crawl_on_match
  
  укажите целевой домен, поддомен или значение шаблона;
  
  Примечание: домен или поддомен указывается без протокола запроса;
  
  пример: "match_value": "dataforseo.com",
  
  "match_value": "/blog/post-*"
- max_crawl_pages
  Тип: integer | null
  
  лимит обхода страниц
  
  необязательное поле
  
  количество страниц результатов поиска для обхода
  
  значение по умолчанию: 1
  
  максимальное значение: 100
  
  Примечание: параметры max_crawl_pages и depth дополняют друг друга;
  
  подробнее в справочном центре
- os
  Тип: string | null
  
  операционная система устройства
  
  необязательное поле
  
  если desktop указан в поле device, выбирайте из значений: windows, macos
  
  значение по умолчанию: windows
  
  если mobile указан в поле device, выбирайте из значений: android, ios
  
  значение по умолчанию: android
- pingback_url
  Тип: string | null
  
  URL уведомления о завершении задачи
  
  необязательное поле
  
  когда задача будет выполнена, мы отправим GET-запрос на указанный вами URL
  
  строку «$id» можно использовать как переменную $id, а «$tag» — как urlencoded-переменную $tag. Перед отправкой запроса мы подставим нужные значения.
  
  пример:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Примечание: специальные символы в pingback_url будут urlencoded;
  
  в частности, символ # кодируется как %23
  
  Подробнее см. в Help Center
- postback_data
  Тип: string
  
  тип данных postback_url
  
  обязательное поле, если указан postback_url
  
  соответствует типу данных, который будет отправлен на ваш сервер
  
  возможные значения:
  
  regular, advanced, html
- postback_url
  Тип: string | null
  
  URL для отправки результатов задачи
  
  необязательное поле
  
  когда задача будет выполнена, мы отправим POST-запрос с результатами, сжатыми в формате gzip, на указанный вами postback_url
  
  строку «$id» можно использовать как переменную $id, а «$tag» — как urlencoded-переменную $tag. Перед отправкой запроса мы подставим нужные значения.
  
  пример:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Примечание: специальные символы в postback_url будут urlencoded;
  
  в частности, символ # кодируется как %23
  
  Подробнее см. в Help Center
- priority
  Тип: integer | null
  
  приоритет задачи
  
  необязательное поле
  
  может принимать следующие значения:
  
  1 — обычный приоритет выполнения (устанавливается по умолчанию)
  
  2 — высокий приоритет выполнения
  
  За задачи с высоким приоритетом выполнения взимается дополнительная плата.
  Стоимость можно рассчитать на странице Тарифы.
- search_param
  Тип: string | null
  
  дополнительные параметры поискового запроса
  
  необязательное поле
  
  список доступных параметров и подробности — здесь
- stop_crawl_on_match
  Тип: array (object | null)[] | null
  
  массив целей для остановки обхода необязательное поле если указано, ответ будет содержать результаты SERP до указанного match_value включительно; в этом массиве можно указать до 10 целевых значений пример: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] подробнее об этом параметре — в нашем справочном центре: https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api оплата взимается за каждый SERP, обойдённый по указанным целям
  
  match_type
  Тип: string | null
  
  тип сопоставления цели обязательное поле, если указан stop_crawl_on_match; тип сопоставления для match_value возможные значения: domain, with_subdomains, wildcard
  
  match_value
  Тип: string | null
  
  целевой домен или значение с подстановкой обязательное поле, если указан stop_crawl_on_match; укажите целевой домен или значение с подстановкой; Примечание: имя домена указывается без протокола запроса; пример: dataforseo.com
- tag
  Тип: string | null
  
  пользовательский идентификатор задачи
  
  необязательное поле
  
  ограничение — 255 символов
  
  этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
  
  указанное значение tag вы найдёте в объекте data ответа
- url
  Тип: string | null
  
  прямой URL поискового запроса
  
  необязательное поле
  
  вы можете указать прямой URL, и мы разберём его по нужным полям. Учтите, что этот способ самый сложный для обработки нашим API и требует указать в URL точный язык и местоположение. В большинстве случаев мы не рекомендуем этот способ.
  
  пример:
  
  https://www.bing.com/search?q=rank%20checker&count=50&first=1&setlang=en&cc=US&safesearch=Moderate&FORM=SEPAGE

Ответы

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

общая стоимость задач, USD

status_code
Тип: integer | null

общий код состояния. Полный список кодов ответа можно найти здесь.

status_message
Тип: string | null

общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.

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

массив задач

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

общая стоимость задач, USD

data
Тип: object | null

содержит те же параметры, что вы указали в POST-запросе

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

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

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

путь URL

result
Тип: object | null

массив результатов
в этом случае значение будет null

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/serp/bing/organic/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/bing/organic/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

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

{
  "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": null
    }
  ]
}

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

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

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

Постановка задач органической выдачи Bing

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

DataForSEO

Постановка задач органической выдачи Bing

Справочные цены

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