# Постановка завдань OnPage

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/on_page/task_post`

**Tags:** DataForSEO

Запускає обхід `target` і повертає `id` завдання в `tasks[0].id` — **цей id потрібен усім іншим інструментам родини**, збережіть його. `max_crawl_pages` обмежує обхід, `start_url`, `max_crawl_depth`, `priority_urls` і `crawl_delay` задають його форму, а `store_raw_html` визначає, чи буде в `post_dataforseo_on_page_raw_html` що повертати пізніше. Відповідь обгорнуто в конверт DataForSEO: дані в `tasks[0].result`, результат у `tasks[0].status_code` — відхилений запит усе одно повертає HTTP 200. ⚠️ Це не звичайна пара «надсилання/отримання»: обхід — це сеанс, який потім опитують за id десятки інших інструментів. Опитуйте `get_dataforseo_on_page_summary`, доки `crawl_progress` не стане `finished`; обхід example.com на одну сторінку тривав значно менше хвилини.

### Довідкові ціни

- Тарифікація: вартість відповіді за даними постачальника.
- Довідкова оцінка запиту: USD 0.003.
- Довідковий множник для клієнта: 1.0. Не застосовуйте його повторно до вже розрахованої суми клієнта.

Довідкові метадані, а не котирування для облікового запису, гарантована ціна чи ліміт витрат. Кредити ресурсів — це не кредити Felo. Остаточні списання здійснюються за записами білінгу Felo.

## Related links

- [live-ендпоінт Instant Pages](<https://docs.dataforseo.com/v3/on_page/instant_pages/?bash>)
- [ендпоінт OnPage Raw HTML](<https://docs.dataforseo.com/v3/on_page/raw_html/>)
- [ендпоінт OnPage Content Parsing](<https://docs.dataforseo.com/v3/on_page/content_parsing/live/>)
- [довідковій статті](<https://dataforseo.com/help-center/cost-of-onpage-api-parameters>)
- [Тарифи](<https://dataforseo.com/pricing/on-page/onpage-api>)
- [ендпоінт OnPage API Microdata](<https://docs.dataforseo.com/v3/on_page/microdata/>)
- [Hunspell](<http://hunspell.github.io/>)
- [ендпоінта Keyword Density](<https://docs.dataforseo.com/v3/on_page/keyword_density?bash>)
- [довідковому центрі](<https://dataforseo.com/help-center/how-to-disable-sitewide-checks-in-onpage-api>)
- [Help Center](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "target": {
            "type": "string",
            "description": "<em>цільовий домен</em><br><strong>обов'язкове поле</strong><br>ім'я домену вказується без <code>https://</code> і <code>www.</code><br>якщо вказати URL сторінки, результати повернуться для домену, що входить до цього URL"
          },
          "max_crawl_pages": {
            "type": "integer",
            "description": "<em>ліміт сторінок для обходу</em><br><strong>обов'язкове поле</strong><br>кількість сторінок для обходу на вказаному домені<br><strong>Примітка:</strong><br>якщо задати <code>max_crawl_pages</code> = 1 і не вказувати <code>start_url</code> або вказати в ньому домашню сторінку, наведені перевірки всього сайту буде вимкнено:<br><code>test_canonicalization</code>, <code>enable_www_redirect_check</code>, <code>test_hidden_server_signature</code>, <code>test_page_not_found</code>, <code>test_directory_browsing</code>, <code>test_https_redirect</code><br>щоб усе одно їх увімкнути, встановіть <code>force_sitewide_checks</code> у <code>true</code>якщо задати <code>max_crawl_pages</code> = 1 і вказати в <code>start_url</code> не домашню сторінку, всі перевірки всього сайту буде вимкнено;<br>щоб усе одно їх увімкнути, встановіть <code>force_sitewide_checks</code> у <code>true</code>"
          },
          "start_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>перший URL для обходу </em><br>необов'язкове поле<br><strong>Примітка:</strong> потрібно вказати абсолютний URL<br>щоб обійти одну сторінку, вкажіть її URL у цьому полі та додатково встановіть параметр <code>max_crawl_pages</code> у <code>1</code><br>також можна використовувати live-ендпоінт Instant Pages для отримання даних щодо конкретної сторінки"
          },
          "force_sitewide_checks": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>увімкнути перевірки всього сайту під час обходу однієї сторінки</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб отримувати дані перевірок усього сайту під час обходу однієї сторінки;<br>значення за замовчуванням: <code>false</code>"
          },
          "priority_urls": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>URL для обходу поза чергою</em><br>необов'язкове поле<br>URL із цього масиву обходяться в першу чергу, оминаючи чергу обходу;<br><strong>Примітка:</strong> потрібно вказувати абсолютний URL;<br>можна вказати до <strong>20 URL</strong>;<br>усі URL у масиві мають належати домену <code>target</code>;<br>піддомени ігноруються, якщо параметр <code>allow_subdomains</code> не встановлено в <code>true</code>приклад:<br>`\"priority_urls\": [<br>\"https://dataforseo.com/apis/serp-api\",<br>\"https://dataforseo.com/contact\"<br>]`"
          },
          "max_crawl_depth": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>глибина обходу</em><br>необов'язкове поле<br>глибина зв'язків сторінок для обходу;<br>наприклад, стартова сторінка обходу — рівень 0, сторінки, на які з неї ведуть посилання, — рівень 1 тощо."
          },
          "crawl_delay": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>затримка між запитами, мс</em><br>необов'язкове поле<br>користувацька затримка між запитами краулера до сервера<br>значення за замовчуванням: <code>2000</code>"
          },
          "store_raw_html": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>зберігати HTML обійдених сторінок</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб отримувати HTML сторінки через ендпоінт OnPage Raw HTML<br>значення за замовчуванням: <code>false</code>"
          },
          "enable_content_parsing": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>розбір контенту обійдених сторінок</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб використовувати ендпоінт OnPage Content Parsing<br>значення за замовчуванням: <code>false</code>"
          },
          "support_cookies": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>підтримка cookie на обійдених сторінках</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб підтримувати cookie під час обходу сторінок<br>значення за замовчуванням: <code>false</code>"
          },
          "accept_language": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>мовний заголовок для доступу до вебсайту</em><br>необов'язкове поле<br>підтримуються всі формати локалей (xx, xx-XX, xxx-XX тощо)<br><strong>Примітка:</strong> якщо не вказати цей параметр, деякі вебсайти можуть відмовити в доступі; у цьому разі сторінки буде повернуто з <code>\"type\":\"broken</code> у масиві відповіді"
          },
          "custom_robots_txt": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>користувацькі налаштування robots.txt</em><br>необов'язкове поле<br>приклад: <code>Disallow: /directory1/</code>"
          },
          "robots_txt_merge_mode": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>об'єднання з налаштуваннями robots.txt або їх перевизначення</em><br>необов'язкове поле<br>можливі значення: <code>merge</code>, <code>override</code>;<br>встановіть <code>override</code>, якщо хочете ігнорувати обмеження обходу сайту та інші налаштування robots.txt<br>значення за замовчуванням: <code>merge</code>;<br><strong>Примітка:</strong> якщо задано <code>override</code>, вкажіть параметр <code>custom_robots_txt</code>"
          },
          "custom_user_agent": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>власний user agent</em><br>необов'язкове поле<br>власний user agent для обходу вебсайту<br>приклад: <code>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<br></code><br>значення за замовчуванням: <code>Mozilla/5.0 (compatible; RSiteAuditor)</code>"
          },
          "browser_preset": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>пресет параметрів екрана браузера</em><br>необов'язкове поле<br>якщо ви використовуєте це поле, указувати <code>browser_screen_width</code>, <code>browser_screen_height</code>, <code>browser_screen_scale_factor</code> не потрібно. можливі значення:<br><code>desktop</code>, <code>mobile</code>, <code>tablet</code><code>desktop</code> пресет застосовує такі значення:<code>browser_screen_width: 1920</code><br><code>browser_screen_height: 1080</code><br><code>browser_screen_scale_factor: 1</code><code>mobile</code> пресет застосовує такі значення:<code>browser_screen_width: 390</code><br><code>browser_screen_height: 844</code><br><code>browser_screen_scale_factor: 3</code><code>tablet</code> пресет застосовує такі значення:<code>browser_screen_width: 1024</code><br><code>browser_screen_height: 1366</code><br><code>browser_screen_scale_factor: 2</code><br><strong>Примітка:</strong> щоб використовувати цей параметр, установіть для <code>enable_javascript</code> або <code>enable_browser_rendering</code> значення <code>true</code>"
          },
          "browser_screen_width": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>ширина екрана браузера</em><br>необов'язкове поле<br>можна задати власну ширину екрана браузера для аудиту конкретного пристрою;<br>якщо ви використовуєте це поле, указувати <code>browser_preset</code> не потрібно, оскільки його буде проігноровано;<br><strong>Примітка:</strong> щоб використовувати цей параметр, установіть для <code>enable_javascript</code> або <code>enable_browser_rendering</code> значення <code>true</code> мінімальне значення в пікселях: <code>240</code><br>максимальне значення в пікселях: <code>9999</code>",
            "format": "int64"
          },
          "browser_screen_height": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>висота екрана браузера</em><br>необов'язкове поле<br>можна задати власну висоту екрана браузера для аудиту конкретного пристрою;<br>якщо ви використовуєте це поле, указувати <code>browser_preset</code> не потрібно, оскільки його буде проігноровано;<br><strong>Примітка:</strong> щоб використовувати цей параметр, установіть для <code>enable_javascript</code> або <code>enable_browser_rendering</code> значення <code>true</code> мінімальне значення в пікселях: <code>240</code><br>максимальне значення в пікселях: <code>9999</code>"
          },
          "browser_screen_scale_factor": {
            "type": [
              "number",
              "null"
            ],
            "description": "<em>масштаб екрана браузера</em><br>необов'язкове поле<br>можна задати власне співвідношення роздільності екрана браузера для аудиту конкретного пристрою;<br>якщо ви використовуєте це поле, указувати <code>browser_preset</code> не потрібно, оскільки його буде проігноровано;<br><strong>Примітка:</strong> щоб використовувати цей параметр, установіть для <code>enable_javascript</code> або <code>enable_browser_rendering</code> значення <code>true</code> мінімальне значення: <code>0.5</code><br>максимальне значення: <code>3</code>"
          },
          "respect_sitemap": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>дотримуватися sitemap під час обходу</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб під час обходу дотримуватися порядку сторінок, вказаного в основному sitemap;<br>значення за замовчуванням: <code>false</code><br><strong>Примітка:</strong> якщо задати <code>true</code>, значення <code>click_depth</code> у відповіді API дорівнюватиме <code>0</code>;<br>поле <code>max_crawl_depth</code> запиту буде проігноровано; кількість сторінок для обходу можна задати параметром <code>max_crawl_pages</code>"
          },
          "custom_sitemap": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL користувацького sitemap</em><br>необов'язкове поле<br>URL сторінки, на якій розміщено альтернативний sitemap<br><strong>Примітка:</strong> щоб використовувати цей параметр, <code>respect_sitemap</code> має бути <code>true</code>"
          },
          "crawl_sitemap_only": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>обходити лише сторінки, вказані в sitemap</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб обходити лише сторінки, вказані в sitemap<br>якщо задати цей параметр як <code>true</code> і не вказувати <code>custom_sitemap</code>, ми обійдемо sitemap за замовчуванням<br>значення за замовчуванням: <code>false</code><br><strong>Примітка:</strong> щоб використовувати цей параметр, <code>respect_sitemap</code> має бути <code>true</code>"
          },
          "load_resources": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>завантажувати ресурси</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб завантажувати зображення, таблиці стилів, скрипти та недоступні ресурси<br>значення за замовчуванням: <code>false</code><br><strong>Примітка:</strong> використання цього параметра спричиняє додаткові витрати; докладніше про вартість завдань із цим параметром — у довідковій статті; вартість можна розрахувати на сторінці Тарифи"
          },
          "enable_www_redirect_check": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>перевіряти, чи налаштовано на домені переадресацію www</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб перевірити, чи налаштовано на запитаному домені переадресацію з www на без-www або з без-www на www;<br>значення за замовчуванням: <code>false</code>"
          },
          "enable_javascript": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>завантажувати javascript на сторінці</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб завантажувати скрипти, доступні на сторінці<br>значення за замовчуванням: <code>false</code><br><strong>Примітка:</strong> використання цього параметра спричиняє додаткові витрати; докладніше про вартість завдань із цим параметром — у довідковій статті; вартість можна розрахувати на сторінці Тарифи"
          },
          "enable_xhr": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>увімкнути XMLHttpRequest на сторінці</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб наш краулер запитував дані з вебсервера через об'єкт XMLHttpRequest<br>значення за замовчуванням: <code>false</code>;якщо ви використовуєте це поле, <code>enable_javascript</code> має бути встановлений у <code>true</code>;"
          },
          "enable_browser_rendering": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>емуляція браузера для вимірювання Core Web Vitals</em><br>необов'язкове поле<br>із цим параметром можна емулювати браузер під час завантаження вебсторінки;<br><code>enable_browser_rendering</code> завантажує стилі, зображення, шрифти, анімації, відео та інші ресурси сторінки;<br>значення за замовчуванням: <code>false</code><br>встановіть <code>true</code>, щоб отримувати у відповіді метрики Core Web Vitals (FID, CLS, LCP);<br><strong>якщо ви використовуєте це поле, параметри <code>enable_javascript</code> і <code>load_resources</code> мають бути встановлені в <code>true</code></strong><br><strong>Примітка:</strong> використання цього параметра спричиняє додаткові витрати; докладніше про вартість завдань із цим параметром — у довідковій статті; вартість можна розрахувати на сторінці Тарифи"
          },
          "disable_cookie_popup": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>вимкнути спливне вікно згоди на cookie</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб вимкнути спливне вікно із запитом згоди на використання cookie;<br>значення за замовчуванням:<br><code>false</code>"
          },
          "custom_js": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>користувацький javascript</em><br>необов'язкове поле<br><strong>Примітка:</strong> час виконання скрипта, який ви вводите тут, має бути не більше 700 мс; наприклад, наведений нижче JS-фрагмент перевіряє, чи містить сайт Google Tag Manager в атрибуті <code>scr</code>:<br><code>let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i &lt; document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute(\"src\");rn if (src != undefined) {rn if (src.indexOf(\"analytics.js\") &gt;= 0)rn      meta.haveGoogleAnalytics = true;rntif (src.indexOf(\"gtm.js\") &gt;= 0)rn      meta.haveTagManager = true;rn  }rn}rnmeta;</code>Повернене значення залежить від того, що ви вказали в цьому полі. Наприклад, якщо вказати такий скрипт:<br>`meta = {}; meta.url = document.URL; meta.test = 'test'; meta;`<br>у відповіді ви отримаєте такі дані:<br>`\"custom_js_response\": {<br>\"url\": \"https://dataforseo.com/\",<br>\"test\": \"test\"<br>}`<br><strong>Примітка:</strong> довжина скрипта, який ви вводите, не повинна перевищувати 2000 символів"
          },
          "validate_micromarkup": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>увімкнути перевірку мікророзмітки</em><br>необов'язкове поле<br>встановіть <code>true</code>, щоб використовувати ендпоінт OnPage API Microdata<br>значення за замовчуванням: <code>false</code>"
          },
          "allow_subdomains": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>включати сторінки на піддоменах</em><br>необов'язкове поле<br>установіть <code>true</code>, якщо хочете обходити всі піддомени цільового вебсайту<br>значення за замовчуванням: <code>false</code>"
          },
          "allowed_subdomains": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>піддомени для обходу</em><br>необов'язкове поле<br>укажіть піддомени, які хочете обійти<br>приклад: <code>[\"blog.site.com\", \"my.site.com\", \"shop.site.com\"]</code><br><strong>Примітка:</strong> щоб використовувати цей параметр, параметр <code>allow_subdomains</code> має бути встановлений у <code>false</code>;<br>інакше вміст поля <code>allowed_subdomains</code> буде проігноровано, і результати буде повернуто для всіх піддоменів"
          },
          "disallowed_subdomains": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>піддомени, які не потрібно обходити</em><br>необов'язкове поле<br>вкажіть піддомени, які ви не хочете обходити<br>приклад: <code>[\"status.site.com\", \"docs.site.com\"]</code><br><strong>Примітка:</strong> щоб використовувати цей параметр, параметр <code>allow_subdomains</code> має бути встановлений у <code>true</code>"
          },
          "check_spell": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>перевіряти орфографію</em><br>необов'язкове поле<br>установіть <code>true</code>, щоб перевіряти орфографію на вебсайті за допомогою бібліотеки Hunspell<br>значення за замовчуванням: <code>false</code>"
          },
          "check_spell_language": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>мова перевірки орфографії</em><br>необов'язкове поле<br>підтримувані мови: 'hy', 'eu', 'bg', 'ca', 'hr', 'cs', 'da', 'nl', 'en', 'eo', 'et', 'fo', 'fa', 'fr', 'fy', 'gl', 'ka', 'de', 'el', 'he', 'hu', 'is', 'ia', 'ga', 'it', 'rw', 'la', 'lv', 'lt', 'mk', 'mn', 'ne', 'nb', 'nn', 'pl', 'pt', 'ro', 'gd', 'sr', 'sk', 'sl', 'es', 'sv', 'tr', 'tk', 'uk', 'vi'<br><strong>Примітка:</strong> якщо мову не вказано, її буде встановлено автоматично на основі вмісту сторінки"
          },
          "check_spell_exceptions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>слова, виключені з перевірки орфографії</em><br>необов'язкове поле<br>укажіть слова, які потрібно виключити з перевірки орфографії<br>максимальна довжина слова: 100 символів<br>максимальна кількість слів: 1000<br>приклад: <code>\"SERP\", \"minifiers\", \"JavaScript\"</code>"
          },
          "calculate_keyword_density": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>розраховувати щільність ключових слів для цільового домену</em><br>необов'язкове поле<br>установіть <code>true</code>, якщо хочете розрахувати щільність ключових слів для сторінок вебсайту<br>значення за замовчуванням: <code>false</code><br><strong>Примітка:</strong> під час використання цього параметра стягується додаткова плата; докладніше про вартість завдань із цим параметром — у нашій статті довідки<br>після завершення обходу значення щільності ключових слів можна отримати за допомогою ендпоінта Keyword Density"
          },
          "checks_threshold": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": {
              "type": [
                "integer",
                "null"
              ],
              "format": "int64"
            },
            "description": "<em>власні порогові значення для перевірок</em><br>необов'язкове поле<br>можна вказати власні порогові значення для параметрів, що входять до об'єкта <code>checks</code> відповідей OnPage API;<br><strong>Примітка:</strong> змінювати можна лише цілочисельні порогові значення;<br>наприклад, параметри <code>high_loading_time</code> і <code>large_page_size</code> за замовчуванням становлять 3 секунди та 1 мегабайт відповідно;<br>якщо ви хочете змінити ці пороги на 1 секунду та 1000 КБ, використовуйте такий фрагмент:<br>`\"checks_threshold\": {<br>\"high_loading_time\": 1,<br>\"large_page_size\": 1000<br>}`<br>доступні параметри, які можна налаштувати, зі значеннями за замовчуванням:<br>`\"title_too_short\", default value: 30, type: \"int\"<br>\"title_too_long\", default value: 65, type: \"int\"<br>\"small_page_size\", default value: 1024, type: \"int\"<br>\"large_page_size\", default value: 1048576 (1024 * 1024), type: \"int\"<br>\"low_character_count\", default value: 1024, type: \"int\"<br>\"high_character_count\", default value: 256000 (250 * 1024), type: \"int\"<br>\"low_content_rate\", default value: 0.1, type: \"float\"<br>\"high_content_rate\", default value: 0.9, type: \"float\"<br>\"high_loading_time\", default value: 3000, type: \"int\"<br>\"high_waiting_time\", default value: 1500, type: \"int\"<br>\"low_readability_rate\", default value: 15.0, type: \"float\"<br>\"irrelevant_description\", default value: 0.2, type: \"float\"<br>\"irrelevant_title\", default value: 0.3, type: \"float\"<br>\"irrelevant_meta_keywords\", default value: 0.6, type: \"float\"`"
          },
          "disable_sitewide_checks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>заборонити виконання окремих перевірок усього сайту</em><br>необов'язкове поле<br>вкажіть наведені <code>checks</code>, щоб вони не виконувалися на сайті <code>target</code>:<br><code>\"test_page_not_found\"</code><br><code>\"test_canonicalization\"</code><br><code>\"test_https_redirect\"</code><br><code>\"test_directory_browsing\"</code>приклад:<br><code>\"disable_sitewide_checks\": [\"test_directory_browsing\", \"test_page_not_found\"]</code>докладніше в довідковому центрі"
          },
          "disable_page_checks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>заборонити виконання окремих перевірок сторінки</em><br>необов'язкове поле<br>вкажіть певні <code>checks</code>, щоб вони не виконувалися й не впливали на <code>onpage_score</code>приклад:<br><code>\"disable_page_checks\": [\"is_5xx_code\", \"is_4xx_code\"]</code>"
          },
          "switch_pool": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>перемикання пулу проксі</em><br>необов'язкове поле<br>якщо <code>true</code>, для отримання запитаних даних використовуватимуться додаткові пули проксі;<br>параметр можна використовувати, якщо одночасно задано багато завдань, що призводить до періодичних помилок <code>rate-limit</code> та/або <code>site_unreachable</code>"
          },
          "return_despite_timeout": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>повертати дані сторінок попри помилку тайм-ауту</em><br>необов'язкове поле<br>якщо <code>true</code>, дані буде надано для сторінок, які не завантажилися за 120 секунд і повернули помилку тайм-ауту;<br>значення за замовчуванням: <code>false</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>визначений користувачем ідентифікатор завдання</em><br>необов'язкове поле<br><em>обмеження — 255 символів</em><br>цей параметр дає змогу ідентифікувати завдання й зіставити його з результатом<br>вказане значення <code>tag</code> ви знайдете в об'єкті <code>data</code> відповіді"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL сповіщення про завершення завдання</em><br>необов'язкове поле<br>коли завдання буде виконано, ми надішлемо GET-запит на вказаний вами URL<br>рядок «$id» можна використовувати як змінну <code>$id</code>, а «$tag» — як urlencoded-змінну <code>$tag</code>. Перед надсиланням запиту ми підставимо потрібні значення.<br>приклад:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>Примітка:</strong> спеціальні символи в <code>pingback_url</code> буде urlencoded;<br>зокрема, символ <code>#</code> кодується як <code>%23</code><p>Докладніше див. в Help Center"
          }
        },
        "example": [
          {
            "target": "dataforseo.com",
            "max_crawl_pages": 10,
            "load_resources": true,
            "enable_javascript": true,
            "custom_js": "meta = {}; meta.url = document.URL; meta;",
            "tag": "some_string_123",
            "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "target": "dataforseo.com",
      "max_crawl_pages": 10,
      "load_resources": true,
      "enable_javascript": true,
      "custom_js": "meta = {}; meta.url = document.URL; meta;",
      "tag": "some_string_123",
      "pingback_url": "https://your-server.com/pingscript?id=$id&tag=$tag"
    }
  ]
}
```

## Responses

### 200 — Успішна операція

Headers:
- `X-Request-Id` (string) — Ідентифікатор запиту, який потрібно вказати під час звернення до підтримки Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_OnPageTaskPostResponseInfo"
    }
  ]
}
```

### 400 — Не вдалося обробити запит. Перевірте параметри запиту.

### 401 — Потрібен дійсний API-ключ Felo.

### 402 — Запит неможливо виконати: умови білінгу не виконано.

### 403 — Обліковий запис не має дозволу на цю операцію.

### 429 — Досягнуто ліміту запитів або витрат.

### 502 — Служба не змогла виконати запит.

### 503 — API або служба білінгу тимчасово недоступні.

### 504 — Час очікування обробки запиту вичерпано.

### default — Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "поточна версія API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "загальний код стану.\nПовний список кодів відповіді можна знайти тут."
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "загальне інформаційне повідомлення.\nПовний список загальних інформаційних повідомлень можна знайти тут."
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "загальний час виконання, секунди"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "загальна вартість завдань, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "кількість завдань у масиві tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "кількість завдань у масиві tasks, повернутих з помилкою",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "ідентифікатор завдання\nунікальний ідентифікатор завдання в нашій системі у форматі UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "код стану завдання\nформується DataForSEO, може перебувати в діапазоні 10000-60000\nПовний список кодів відповіді можна знайти тут."
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "інформаційне повідомлення завдання\nПовний список загальних інформаційних повідомлень можна знайти тут."
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "час виконання, секунди"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "загальна вартість завдань, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "кількість елементів у масиві result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "шлях URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "містить ті самі параметри, які ви вказали в POST-запиті"
    }
  }
}
```

### Response36Afe1097B20_OnPageTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_OnPageTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_OnPageTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>масив завдань</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_OnPageTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_OnPageTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>масив результатів</em><br>у цьому випадку значення буде <code>null</code>"
        }
      }
    }
  ]
}
```
