DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Сводка OnPage API
Состояние и ключевые метрики одного обхода по id. Возвращает crawl_progress, crawl_status, crawl_gateway_address, crawl_stop_reason, domain_info и page_metrics. Ответ обёрнут в конверт DataForSEO: данные в tasks[0].result, результат в tasks[0].status_code — отклонённый запрос всё равно возвращает HTTP 200. По нему же узнают, что обход завершён: опрашивайте его, пока crawl_progress не станет finished, прежде чем читать любой другой эндпоинт здесь, иначе вы прочитаете частичные результаты, похожие на настоящие. 💰 Бесплатно на стороне upstream: запрос к завершённому обходу ничего не стоит, платить нужно только за сам обход.
Справочные цены
- Тарификация: стоимость ответа по данным провайдера.
- Справочная оценка запроса: USD 0.012.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: object | null · Response36Afe1097B20_OnPageSummaryResponseInfo200
- Тип: number | null Формат: doublecost
общая стоимость задач, USD
- Тип: integer | nullstatus
_code общий код состояния. Полный список кодов ответа можно найти здесь.
- Тип: string | nullstatus
_message общее информационное сообщение. Полный список общих информационных сообщений можно найти здесь.
- Тип: array (object | null)[] | nulltasks
массив задач
- Тип: object | null · Response36Afe1097B20_OnPageSummaryTaskInfo
- 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
_gateway _address - crawlТип: string | null
_progress статус сеанса сканирования
возможные значения:in_progress,finished - crawlТип: object | null · Response36Afe1097B20_CrawlStatusInfo
_status сведения о сеансе сканирования
- maxТип: integer | null Формат: int64
_crawl _pages максимальное количество страниц для обхода указывает заданный при постановке задачи лимит max_crawl_pages
- pagesТип: integer | null Формат: int64
_crawled количество просканированных страниц
- pagesТип: integer | null Формат: int64
_in _queue количество страниц, которые сейчас находятся в очереди на сканирование
- crawlТип: string | null
_stop _reason причина остановки сканирования
информация о причине остановки процесса сканирования;
возможные значения:limit_exceeded— превышен лимит, заданный вmax_crawl_pages;empty_queue— все URL в очереди просканированы;force_stopped— процесс сканирования остановлен с помощью функции On Page API Force Stop;unexpected_exception— при сканированииtargetвозникла внутренняя ошибка; обратитесь в поддержку за подробностями - domainТип: object | null · Response36Afe1097B20_DomainInfo
_info информация по всему домену
информация OnPage о целевом домене и процессе сканирования- canonicalizationТип: integer | null
_status _code код состояния, возвращённый канонизированной страницей
проверка поведения сервера, когда наш краулер пытается обратиться к сайту по IP;
в большинстве случаев канонизированные страницы должны отвечать кодом состояния301или302 - checksТип: object | null
проверки сайта
прочие проверки страницы, связанные с сайтом- propertyТип: boolean | null
Name
- cmsТип: string | null
система управления контентом
система управления контентом, обнаруженная на сайте
содержимое метатегаgenerator
данные берутся с первой случайной страницы, возвращающей код ответа 200
если наш краулер не смог определить CMS, значение будетnull - crawlТип: string | null
_end время окончания обхода
дата и время завершения обхода
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:2019-11-15 12:57:46 +00:00
Примечание: информативно, только если"crawl_progress"имеет значение"finished"
если"crawl_progress"имеет значениеin_progress, значение будетnull - crawlТип: string | null
_start время начала обхода
дата и время отправки сайта на обход
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:2019-11-15 12:57:46 +00:00 - directoryТип: integer | null
_browsing _status _code код состояния, возвращённый каталогом
код состояния, возвращённый страницей каталога на целевом сайте
в большинстве случаев каталоги должны отвечать кодом состояния403или401 - extendedТип: string | null
_crawl _status статус и ошибки обхода
указывает причину, по которой сайт не был обойдён;
может принимать следующие значения:no_errors- ошибок обхода не обнаружено;site_unreachable- наш краулер не смог подключиться к сайту и поэтому не смог получить код состояния;invalid_page_status_code- код состояния первой обойдённой страницы >= 400;forbidden_meta_tag- первая обойдённая страница содержит тег <meta robots="noindex">;forbidden_robots- robots.txt запрещает обход страницы;forbidden_http_header- HTTP-заголовок страницы содержит "X-Robots-Tag: noindex";too_many_redirects- первая обойдённая страница имеет более 10 перенаправлений;unknown- причина неизвестна - ipТип: string | null
IP-адрес домена
- mainТип: string | null
_domain корневое доменное имя
- nameТип: string | null
имя домена
- pageТип: integer | null
_not _found _status _code код состояния, возвращённый несуществующей страницей
в большинстве случаев сервер должен возвращать код ответа 404 - serverТип: string | null
сервер сайта
версия сервера, обнаруженная на сайте
содержимое заголовкаserver
информация берётся с первой страницы, код ответа которой — 200 - sslТип: object | null · Response36Afe1097B20_SslInfo
_info информация о SSL-сертификате
информация о протоколе Secure Sockets Layer, обнаруженном на сайте- certificateТип: string | null
_expiration _date дата истечения срока действия SSL-сертификата
дата и время истечения срока действия SSL-сертификата
в формате UTC: “yyyy-mm-dd hh-mm-ss +00:00”
пример:2019-11-15 12:57:46 +00:00 - certificateТип: string | null
_hash хеш SSL-сертификата
версия хеш-функции SSL-сертификата - certificateТип: string | null
_issuer центр сертификации SSL
субъект, выдавший обнаруженный SSL-сертификат - certificateТип: string | null
_subject субъект SSL-сертификата
субъект, связанный с открытым ключом - certificateТип: integer | null
_version - validТип: boolean | null
_certificate срок действия SSL-сертификата
указывает, не является ли обнаруженный на веб-сайте SSL-сертификат просроченным, приостановленным, отозванным или недействительным
- totalТип: integer | null Формат: int64
_pages всего обойдено страниц
общее количество обойдённых страниц - totalТип: integer | null Формат: int64
_uncrawlable _resources всего необойдённых ресурсов
общее количество ресурсов, которые не удалось обойти;
ресурс считается необойдённым, если фактический тип контента ресурса не соответствует типу контента, ожидаемому краулером - wwwТип: integer | null
_redirect _status _code код состояния перенаправления
код состояния перенаправления с www на без www
в большинстве случаев перенаправление должно возвращать код состояния301
- pageТип: object | null · Response36Afe1097B20_PageMetrics
_metrics информация по страницам
информация о метриках страниц целевого сайта- brokenТип: integer | null
_links количество битых ссылок
количество битых ссылок на всех просканированных страницах целевого сайта - brokenТип: integer | null
_resources количество битых ресурсов
количество изображений и других ресурсов с битыми ссылками - checksТип: object | null
проверки OnPage по отдельным страницам
- propertyТип: integer | null Формат: int64
Name Signed 64-bit integers (long type).
- duplicateТип: integer | null
_content количество страниц с дублированным контентом
- duplicateТип: integer | null
_description количество страниц с дублированными описаниями
- duplicateТип: integer | null
_title количество страниц с дублированными заголовками
- linksТип: integer | null
_external количество внешних ссылок
количество ссылок, ведущих на другие сайты - linksТип: integer | null
_internal количество внутренних ссылок
количество ссылок, ведущих на другие страницы в пределах целевого сайта - linksТип: integer | null
_relation _conflict количество ссылок на целевом сайте, которые могут конфликтовать
например, если"links_relation_conflict": 2, целевой сайт ссылается на один и тот же источник как минимум одной внутренней ссылкой с атрибутомrel="nofollow"и как минимум одной dofollow-ссылкой - nonТип: integer | null
_indexable - onpageТип: number | null
_score показывает, насколько сайт оптимизирован по 100-балльной шкале
это поле показывает, насколько сайт оптимизирован с учётом обнаруженных критических проблем и предупреждений;100— максимально возможная оценка, означающая, что на сайте нет критических проблем и важных предупреждений;
обратите внимание, что это значение зависит от количества просканированных страниц;
подробнее о расчёте метрики — в этой статье справочного центра - redirectТип: integer | null
_loop количество цепочек перенаправлений, начинающихся и заканчивающихся на одном URL
количество цепочек перенаправлений, в которых целевой URL перенаправляет обратно на исходный URL
- 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/summary/00000000-0000-0000-0000-000000000000 \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"crawl_gateway_address": null,
"crawl_stop_reason": null,
"domain_info": {
"name": null,
"cms": null,
"ip": null,
"server": null,
"crawl_start": null,
"crawl_end": null,
"extended_crawl_status": null,
"ssl_info": "[Max Depth Exceeded]",
"checks": null,
"total_pages": null,
"total_uncrawlable_resources": null,
"page_not_found_status_code": null,
"canonicalization_status_code": null,
"directory_browsing_status_code": null,
"www_redirect_status_code": null,
"main_domain": null
},
"page_metrics": {
"links_external": null,
"links_internal": null,
"duplicate_title": null,
"duplicate_description": null,
"duplicate_content": null,
"broken_links": null,
"broken_resources": null,
"links_relation_conflict": null,
"redirect_loop": null,
"onpage_score": null,
"non_indexable": null,
"checks": null
}
}
]
}
]
}