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
Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника
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
}
}
]
}
]
}