Felo API PlatformFelo API Platform
Усі endpoint DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Скриншот сторінки OnPage API

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клієнтські бібліотеки
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операції

Скриншот сторінки 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.

Тіло
application/json
  • Тип: array (object | null)[]
    • accept_language
      Тип: string | null

      мовний заголовок для доступу до вебсайту
      необов'язкове поле
      підтримуються всі формати локалей (xx, xx-XX, xxx-XX тощо)
      примітка: якщо не вказати цей параметр, деякі вебсайти можуть відмовити в доступі; у цьому разі в масиві відповіді ви отримаєте "error_message":"Screenshot is empty"

    • browser_preset
      Тип: string | null

      пресет параметрів екрана браузера
      необов'язкове поле
      якщо ви використовуєте це поле, указувати browser_screen_width, browser_screen_height, browser_screen_scale_factor не потрібно

      можливі значення:
      desktop, mobile, tablet

      пресет desktop застосовує такі значення:

      browser_screen_width: 1920
      browser_screen_height: 1080
      browser_screen_scale_factor: 1

      пресет mobile застосовує такі значення:

      browser_screen_width: 390
      browser_screen_height: 844
      browser_screen_scale_factor: 3

      пресет tablet застосовує такі значення:

      browser_screen_width: 1024
      browser_screen_height: 1366
      browser_screen_scale_factor: 2

      Примітка: у цьому ендпоінті параметри enable_browser_rendering, enable_javascript, load_resources і enable_xhr завжди ввімкнено.

    • browser_screen_height
      Тип: integer | null

      висота екрана браузера
      необов'язкове поле
      можна задати власну висоту екрана браузера для аудиту конкретного пристрою;
      якщо ви використовуєте це поле, указувати browser_preset не потрібно, оскільки його буде проігноровано;

      мінімальне значення в пікселях: 240
      максимальне значення в пікселях: 9999

    • browser_screen_scale_factor
      Тип: number | null

      масштаб екрана браузера
      необов'язкове поле
      можна задати власне співвідношення роздільності екрана браузера для аудиту конкретного пристрою;
      якщо ви використовуєте це поле, указувати browser_preset не потрібно, оскільки його буде проігноровано;

      мінімальне значення: 0.5
      максимальне значення: 3

    • browser_screen_width
      Тип: integer | null Формат: int64

      ширина екрана браузера
      необов'язкове поле
      можна задати власну ширину екрана браузера для аудиту конкретного пристрою;
      якщо ви використовуєте це поле, указувати browser_preset не потрібно, оскільки його буде проігноровано;

      мінімальне значення в пікселях: 240
      максимальне значення в пікселях: 9999

    • custom_user_agent
      Тип: string | null

      власний 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_cookie_popup
      Тип: boolean | null

      вимкнути спливаюче вікно cookie
      необов'язкове поле
      установіть true, якщо хочете вимкнути спливаюче вікно із запитом згоди на використання cookie;
      значення за замовчуванням:
      false

    • full_page_screenshot
      Тип: boolean | null

      зробити знімок усієї сторінки
      необов'язкове поле
      установіть false, якщо хочете захопити лише частину сторінки, що відображається до прокручування
      значення за замовчуванням: true

    • ip_pool_for_scan
      Тип: string | null

      пул проксі
      необов'язкове поле
      можна вибрати розташування пулу проксі, який використовуватиметься для отримання запитаних даних;
      параметр можна використовувати, якщо вміст сторінки недоступний в одному з розташувань, що призводить до періодичних помилок site_unreachable
      можливі значення: us, de

    • switch_pool
      Тип: boolean | null

      перемикання пулу проксі
      необов'язкове поле
      якщо true, для отримання запитаних даних використовуватимуться додаткові пули проксі;
      параметр можна використовувати, якщо одночасно задано багато завдань, що призводить до періодичних помилок rate-limit та/або site_unreachable

    • url
      Тип: string

      URL сторінки
      обов'язкове поле
      абсолютний URL сторінки для знімка
      примітка: якщо вказаний тут URL повертає код стану 404 або вказане значення не є допустимим URL, у масиві відповіді ви отримаєте "error_message":"Screenshot is empty"

Відповіді
  • 200
    Тип: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo
    • cost
      Тип: number | null Формат: double

      загальна вартість завдань, USD

    • status_code
      Тип: integer | null

      загальний код стану. Повний список кодів відповіді можна знайти тут.

    • status_message
      Тип: string | null

      загальне інформаційне повідомлення. Повний список загальних інформаційних повідомлень можна знайти тут.

    • tasks
      Тип: array (object | null)[] | null

      масив завдань

      • Тип: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
        • cost
          Тип: number | null Формат: double

          загальна вартість завдань, USD

        • data
          Тип: object | null

          містить ті самі параметри, які ви вказали в POST-запиті

          • propertyName
            Тип: object | null
        • id
          Тип: string | null

          ідентифікатор завдання унікальний ідентифікатор завдання в нашій системі у форматі UUID

        • path
          Тип: array (string | null)[] | null

          шлях URL

        • result
          Тип: array (object | null)[] | null

          масив результатів

          • crawl_progress
            Тип: string | null

            статус сеансу сканування
            можливі значення: in_progress, finished

          • error_message
            Тип: string | null

            повідомлення про помилку
            якщо зазначений url повертає код стану 404 або не є дійсним URL, ви отримаєте "error_message":"Screenshot is empty"
            якщо помилки немає, значення буде null

          • items
            Тип: array (object | null)[] | null

            масив елементів

            • image
              Тип: string | null

              скриншот запитаної сторінки
              URL скриншота сторінки у сховищі DataForSEO
              примітка: скриншот сторінки, збережений у сховищі DataForSEO, доступний лише протягом одного дня після виконання запиту

          • items_count
            Тип: integer | null Формат: int64

            кількість елементів у масиві результатів

        • result_count
          Тип: integer | null Формат: int64

          кількість елементів у масиві result

        • status_code
          Тип: integer | null

          код стану завдання формується DataForSEO, може перебувати в діапазоні 10000-60000 Повний список кодів відповіді можна знайти тут.

        • status_message
          Тип: string | null

          інформаційне повідомлення завдання Повний список загальних інформаційних повідомлень можна знайти тут.

        • time
          Тип: string | null

          час виконання, секунди

    • tasks_count
      Тип: integer | null Формат: int64

      кількість завдань у масиві tasks

    • tasks_error
      Тип: integer | null Формат: int64

      кількість завдань у масиві tasks, повернутих з помилкою

    • time
      Тип: string | null

      загальний час виконання, секунди

    • version
      Тип: string | null

      поточна версія API

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for post/v1/beta/dataforseo/on_page/page_screenshot
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
            }
          ]
        }
      ]
    }
  ]
}

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

OnPage API Page Screenshot