DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Скриншот страницы OnPage API
Рендерит любой url и возвращает скриншот; full_page_screenshot включает всю высоту прокрутки, а browser_screen_width и browser_screen_height задают область просмотра. Работает автономно — обход не нужен. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. ⚠️ Изображение — большой результат инструмента ещё до того, как агент сможет с ним что-то сделать; запрашивайте скриншот, только когда важен именно визуал, а если нужен текст, используйте post_dataforseo_on_page_content_parsing_live.
Справочные цены
- Тарификация: стоимость ответа по данным провайдера.
- Справочная оценка запроса: USD 0.0051.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: array (object | null)[]
- acceptТип: string | null
_language языковой заголовок для доступа к веб-сайту
необязательное поле
поддерживаются все форматы локалей (xx, xx-XX, xxx-XX и т. д.)
примечание: если не указать этот параметр, некоторые веб-сайты могут отказать в доступе; в этом случае в массиве ответа вы получите"error_message":"Screenshot is empty" - browserТип: string | null
_preset пресет параметров экрана браузера
необязательное поле
если вы используете это поле, указыватьbrowser_screen_width,browser_screen_height,browser_screen_scale_factorне нужновозможные значения:
desktop,mobile,tabletпресет
desktopприменяет следующие значения:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1пресет
mobileприменяет следующие значения:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3пресет
tabletприменяет следующие значения:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2Примечание: в этом эндпоинте параметры
enable_browser_rendering,enable_javascript,load_resourcesиenable_xhrвсегда включены. - browserТип: integer | null
_screen _height высота экрана браузера
необязательное поле
можно задать собственную высоту экрана браузера для аудита конкретного устройства;
если вы используете это поле, указыватьbrowser_presetне нужно, так как он будет проигнорирован;минимальное значение в пикселях:
240
максимальное значение в пикселях:9999 - browserТип: number | null
_screen _scale _factor масштаб экрана браузера
необязательное поле
можно задать собственное соотношение разрешения экрана браузера для аудита конкретного устройства;
если вы используете это поле, указыватьbrowser_presetне нужно, так как он будет проигнорирован;минимальное значение:
0.5
максимальное значение:3 - browserТип: integer | null Формат: int64
_screen _width ширина экрана браузера
необязательное поле
можно задать собственную ширину экрана браузера для аудита конкретного устройства;
если вы используете это поле, указыватьbrowser_presetне нужно, так как он будет проигнорирован;минимальное значение в пикселях:
240
максимальное значение в пикселях:9999 - customТип: string | null
_user _agent пользовательский user agent
необязательное поле
пользовательский user agent для обхода веб-сайта
пример:Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36
значение по умолчанию:Mozilla/5.0 (compatible; RSiteAuditor) - disableТип: boolean | null
_cookie _popup отключить всплывающее окно cookie
необязательное поле
задайтеtrue, если хотите отключить всплывающее окно с запросом согласия на использование cookie;
значение по умолчанию:false - fullТип: boolean | null
_page _screenshot сделать снимок всей страницы
необязательное поле
задайтеfalse, если хотите захватить только часть страницы, отображаемую до прокрутки
значение по умолчанию:true - ipТип: string | null
_pool _for _scan пул прокси
необязательное поле
можно выбрать расположение пула прокси, который будет использоваться для получения запрошенных данных;
параметр можно использовать, если содержимое страницы недоступно в одном из расположений, что приводит к периодическим ошибкамsite_unreachable
возможные значения:us,de - switchТип: boolean | null
_pool переключение пула прокси
необязательное поле
еслиtrue, для получения запрошенных данных будут использоваться дополнительные пулы прокси;
параметр можно использовать, если одновременно задано множество задач, что приводит к периодическим ошибкамrate-limitи/илиsite_unreachable - urlТип: string
URL страницы
обязательное поле
абсолютный URL страницы для снимка
примечание: если указанный здесь URL возвращает код состояния 404 или указанное значение не является допустимым URL, в массиве ответа вы получите"error_message":"Screenshot is empty"
- Тип: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo200
- Тип: number | null Формат: doublecost
общая стоимость задач, USD
- Тип: integer | nullstatus
_code общий код состояния. Полный список кодов ответа можно найти здесь.
- Тип: string | nullstatus
_message общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.
- Тип: array (object | null)[] | nulltasks
массив задач
- Тип: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
- costТип: number | null Формат: double
общая стоимость задач, USD
- dataТип: object | null
содержит те же параметры, что вы указали в POST-запросе
- propertyТип: object | null
Name
- idТип: string | null
идентификатор задачи уникальный идентификатор задачи в нашей системе в формате UUID
- pathТип: array (string | null)[] | null
путь URL
- resultТип: array (object | null)[] | null
массив результатов
- crawlТип: string | null
_progress статус сеанса сканирования
возможные значения:in_progress,finished - errorТип: string | null
_message сообщение об ошибке
если указанныйurlвозвращает код состояния 404 или не является допустимым URL, вы получите"error_message":"Screenshot is empty"
если ошибки нет, значение будетnull - itemsТип: array (object | null)[] | null
массив элементов
- imageТип: string | null
скриншот запрошенной страницы
URL скриншота страницы в хранилище DataForSEO
примечание: скриншот страницы, сохранённый в хранилище DataForSEO, доступен только в течение одного дня после выполнения запроса
- itemsТип: integer | null Формат: int64
_count количество элементов в массиве результатов
- 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/on_page/page_screenshot \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"url": "https://dataforseo.com/apis"
}
]'
{
"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": [
{
"crawl_progress": null,
"error_message": null,
"items_count": null,
"items": [
{
"image": null
}
]
}
]
}
]
}