Постановка задач органической выдачи Baidu
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Постановка задач органической выдачи Baidu
Ставит в очередь ранжированные результаты по ключевому слову в Baidu и возвращает id задачи в tasks[0].id. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. Живой двойник отвечает сразу и проще для одного запроса; ставьте в очередь, когда пакет не укладывается во время вызова инструмента.
Справочные цены
- Тарификация: стоимость ответа по данным провайдера.
- Справочная оценка запроса: USD 0.02.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: array (object | null)[]
- depthТип: integer | null
глубина парсинга
необязательное поле
количество результатов в SERP
значение по умолчанию:10
максимальное значение:700
Оплата взимается за каждый SERP, содержащий до 10 результатов;
Установка глубины выше 10 может привести к дополнительным расходам, если поисковая система возвращает более 10 результатов;
Стоимость можно рассчитать на странице Тарифы. - deviceТип: string | null
тип устройства
необязательное поле
возвращать результаты для определённого типа устройства
может принимать значения:desktop,mobile,tablet
значение по умолчанию:desktop - getТип: boolean | null
_website _url включать прямой URL для каждого результата в выдаче
необязательное поле
если задатьtrue, возвращённые результаты будут содержать прямые URL сайтов из выдачи
по умолчанию URL в результатах Baidu кодируются поисковой системой,
например:http://www.baidu.com/link?url=KQt6LSwU5OHnPtB8210R8flBP40grY6lTPxH_0UO7S2kgiZMTmw3ztV0hCo5c1kLзначение по умолчанию:false
Примечание: если задатьtrue, стоимость задачи умножается на 10, так как наша система выполняет отдельный запрос к каждому сайту из выдачи для получения его прямого URL - keywordТип: string
ключевое слово
обязательное поле
в полеkeywordможно указать до 700 символов
все %## декодируются (символ «+» декодируется в пробел)
если вkeywordнужен символ «%», укажите его как «%25»;
если вkeywordнужен символ «+», укажите его как «%2B»Подробнее о правилах и ограничениях полей
keywordиkeywordsв API DataForSEO читайте в статье Help Center - languageТип: string
_code код языка поисковой системы
обязательное поле, если не указанlanguage_name
список доступных языков с ихlanguage_codeможно получить отдельным запросом кhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesОбратите внимание, что в поисковой системе Baidu поддерживается толькоChinese (Simplified)с кодом языкаzh_CN. Однако Baidu может возвращать результаты и по запросам на других языках, поэтому указыватьkeywordна китайском не обязательнопример:
zh_CN - languageТип: string
_name полное название языка поисковой системы
обязательное поле, если не указанlanguage_code
список доступных языков с ихlanguage_nameможно получить отдельным запросом кhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/languagesОбратите внимание, что в поисковой системе Baidu поддерживается толькоChinese (Simplified). Однако Baidu может возвращать результаты и по запросам на других языках, поэтому указыватьkeywordна китайском не обязательнопример:
Chinese (Simplified) - locationТип: integer
_code код местоположения поисковой системы
обязательное поле, если не указанlocation_nameилиlocation_coordinate
если используете это поле,location_nameилиlocation_coordinateуказывать не нужно
список доступных местоположений с ихlocation_codeможно получить отдельным запросом кhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
пример:2156 - locationТип: string
_coordinate GPS-координаты местоположения
обязательное поле, если не указанlocation_nameилиlocation_code
если используете это поле,location_nameилиlocation_codeуказывать не нужно
параметрlocation_coordinateуказывается в формате "latitude,longitude,radius"
максимальное число десятичных цифр для "latitude" и "longitude": 7
минимальное значение "radius": 199.9 (мм)
максимальное значение "radius": 199999 (мм)если используете это поле, возвращённые результаты будут основаны на ближайшем городе, найденном для ваших координат. Поэтому мы не рекомендуем использовать это поле, так как результаты могут не соответствовать указанным координатам
пример:53.476225,-2.243572,200 - locationТип: string
_name полное название местоположения поисковой системы
обязательное поле, если не указанlocation_codeилиlocation_coordinate
если используете это поле,location_codeилиlocation_coordinateуказывать не нужно
список доступных местоположений с ихlocation_nameможно получить отдельным запросом кhttps://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
пример:New York,New York,United States - maxТип: integer | null
_crawl _pages - osТип: string | null
операционная система устройства
необязательное поле
если в полеdeviceуказаноdesktop, выбирайте из значений:windows,macos
значение по умолчанию:windows
если в полеdeviceуказаноmobile, выбирайте из значений:android,ios
значение по умолчанию:android
если в полеdeviceуказаноtablet, выбирайте из значений:android,ios
значение по умолчанию:android - pingbackТип: string | null
_url URL уведомления о завершении задачи
необязательное поле
когда задача будет выполнена, мы отправим GET-запрос на указанный вами URL
строку «$id» можно использовать как переменную$id, а «$tag» — как urlencoded-переменную$tag. Перед отправкой запроса мы подставим нужные значения.
пример:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Примечание: специальные символы вpingback_urlбудут urlencoded;
в частности, символ#кодируется как%23 - postbackТип: string
_data тип данных postback_url
обязательное поле, если указанpostback_url
соответствует типу данных, который будет отправлен на ваш сервер
возможные значения:regular,html - postbackТип: string | null
_url URL для отправки результатов задачи
необязательное поле
когда задача будет выполнена, мы отправим POST-запрос с результатами, сжатыми в форматеgzip, на указанный вамиpostback_url
строку «$id» можно использовать как переменную$id, а «$tag» — как urlencoded-переменную$tag. Перед отправкой запроса мы подставим нужные значения.
пример:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Примечание: специальные символы вpostback_urlбудут urlencoded;
в частности, символ#кодируется как%23 - priorityТип: integer | null
- stopТип: array (object | null)[] | null
_crawl _on _match массив целей для остановки обхода необязательное поле если указано, ответ будет содержать результаты 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Тип: string | null
_type тип сопоставления цели обязательное поле, если указан stop_crawl_on_match; тип сопоставления для match_value возможные значения: domain, with_subdomains, wildcard
- matchТип: string | null
_value целевой домен или значение с подстановкой обязательное поле, если указан stop_crawl_on_match; укажите целевой домен или значение с подстановкой; Примечание: имя домена указывается без протокола запроса; пример: dataforseo.com
- tagТип: string | null
пользовательский идентификатор задачи
необязательное поле
ограничение — 255 символов
этот параметр позволяет идентифицировать задачу и сопоставить её с результатом
указанное значениеtagвы найдёте в объектеdataответа
- Тип: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostResponseInfo200
- Тип: number | null Формат: doublecost
общая стоимость задач, USD
- Тип: integer | nullstatus
_code общий код состояния. Полный список кодов ответа можно найти здесь.
- Тип: string | nullstatus
_message общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.
- Тип: array (object | null)[] | nulltasks
массив задач
- Тип: object | null · Response36Afe1097B20_SerpBaiduOrganicTaskPostTaskInfo
- costТип: number | null Формат: double
общая стоимость задач, USD
- dataТип: object | null
содержит те же параметры, что вы указали в POST-запросе
- propertyТип: object | null
Name
- idТип: string | null
идентификатор задачи уникальный идентификатор задачи в нашей системе в формате UUID
- pathТип: array (string | null)[] | null
путь URL
- resultТип: object | null
массив результатов
в этом случае значение будетnull - resultТип: integer | null Формат: int64
_count число элементов в массиве result
- statusТип: integer | null
_code код состояния задачи формируется DataForSEO, может находиться в диапазоне 10000-60000 Полный список кодов ответа можно найти здесь.
- statusТип: string | null
_message информационное сообщение задачи Полный список общих информационных сообщений можно найти здесь.
- timeТип: string | null
время выполнения, секунды
- Тип: integer | null Формат: int64tasks
_count число задач в массиве tasks
- Тип: integer | null Формат: int64tasks
_error число задач в массиве tasks, возвращённых с ошибкой
- Тип: string | nulltime
общее время выполнения, секунды
- Тип: string | nullversion
текущая версия API
application/json - 400
Запрос не удалось обработать. Проверьте параметры запроса.
- 401
Требуется действительный API-ключ Felo.
- 402
Запрос не может быть выполнен: не выполнено требование биллинга.
- 403
Аккаунту не разрешено выполнять эту операцию.
- 429
Достигнут лимит запросов или расходов.
- 502
Сервис не смог выполнить запрос.
- 503
API или сервис биллинга временно недоступны.
- 504
Истекло время ожидания обработки запроса.
- default
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/baidu/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2156,
"keyword": "best iphone ever",
"tag": "some_string_123",
"priority": 2
}
]'
{
"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
}
]
}