Felo API PlatformFelo API Platform
Všechny endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Snímek obrazovky stránky OnPage API

Felo API Support
MIT
Server:https://openapi.felo.ai
Klientské knihovny
Shell Curl

DataForSEO

​

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

DataForSEO Operace

Snímek obrazovky stránky OnPage API

​

Vykreslí libovolnou url a vrátí snímek obrazovky; full_page_screenshot zahrnuje celou výšku posouvání a browser_screen_width a browser_screen_height nastavují viewport. Samostatné — není potřeba procházení. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code — odmítnutý požadavek stále vrací HTTP 200. ⚠️ Obrázek je velký výsledek nástroje ještě předtím, než s ním agent cokoli udělá; o snímek obrazovky žádejte jen tehdy, když jde o vizuál, a když jde o text, použijte post_dataforseo_on_page_content_parsing_live.

Cenová reference

  • Účtování: nahlášené náklady na odpověď.
  • Referenční odhad požadavku: USD 0.0051.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo
application/json
  • Typ: array (object | null)[]
    • accept_language
      Typ: string | null

      jazyková hlavička pro přístup k webu
      volitelné pole
      podporovány jsou všechny formáty lokalizace (xx, xx-XX, xxx-XX atd.)
      poznámka: pokud tento parametr nezadáte, některé weby mohou přístup odmítnout; v takovém případě v poli odpovědi získáte "error_message":"Screenshot is empty"

    • browser_preset
      Typ: string | null

      předvolba parametrů obrazovky prohlížeče
      volitelné pole
      pokud toto pole použijete, nemusíte uvádět browser_screen_width, browser_screen_height, browser_screen_scale_factor

      možné hodnoty:
      desktop, mobile, tablet

      předvolba desktop použije následující hodnoty:

      browser_screen_width: 1920
      browser_screen_height: 1080
      browser_screen_scale_factor: 1

      předvolba mobile použije následující hodnoty:

      browser_screen_width: 390
      browser_screen_height: 844
      browser_screen_scale_factor: 3

      předvolba tablet použije následující hodnoty:

      browser_screen_width: 1024
      browser_screen_height: 1366
      browser_screen_scale_factor: 2

      Poznámka: v tomto endpointu jsou parametry enable_browser_rendering, enable_javascript, load_resources a enable_xhr vždy povoleny.

    • browser_screen_height
      Typ: integer | null

      výška obrazovky prohlížeče
      volitelné pole
      můžete nastavit vlastní výšku obrazovky prohlížeče pro provedení auditu konkrétního zařízení;
      pokud toto pole použijete, nemusíte uvádět browser_preset, protože bude ignorováno;

      minimální hodnota v pixelech: 240
      maximální hodnota v pixelech: 9999

    • browser_screen_scale_factor
      Typ: number | null

      faktor měřítka obrazovky prohlížeče
      volitelné pole
      můžete nastavit vlastní poměr rozlišení obrazovky prohlížeče pro provedení auditu konkrétního zařízení;
      pokud toto pole použijete, nemusíte uvádět browser_preset, protože bude ignorováno;

      minimální hodnota: 0.5
      maximální hodnota: 3

    • browser_screen_width
      Typ: integer | null Formát: int64

      šířka obrazovky prohlížeče
      volitelné pole
      můžete nastavit vlastní šířku obrazovky prohlížeče pro provedení auditu konkrétního zařízení;
      pokud toto pole použijete, nemusíte uvádět browser_preset, protože bude ignorováno;

      minimální hodnota v pixelech: 240
      maximální hodnota v pixelech: 9999

    • custom_user_agent
      Typ: string | null

      vlastní user agent
      volitelné pole
      vlastní user agent pro procházení webu
      příklad: 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

      výchozí hodnota: Mozilla/5.0 (compatible; RSiteAuditor)

    • disable_cookie_popup
      Typ: boolean | null

      vypnout vyskakovací okno se souhlasem s cookies
      volitelné pole
      nastavte na true, pokud chcete vypnout vyskakovací okno žádající uživatele o souhlas s cookies;
      výchozí hodnota:
      false

    • full_page_screenshot
      Typ: boolean | null

      pořídit snímek celé stránky
      volitelné pole
      nastavte na false, pokud chcete zachytit pouze část stránky zobrazenou před posunutím
      výchozí hodnota: true

    • ip_pool_for_scan
      Typ: string | null

      pula proxy
      volitelné pole
      můžete zvolit umístění poolu proxy, který bude použit k získání požadovaných dat;
      parametr lze použít, pokud je obsah stránky v jedné z lokalit nedostupný, což vede k občasným chybám site_unreachable
      možné hodnoty: us, de

    • switch_pool
      Typ: boolean | null

      přepnout pool proxy
      volitelné pole
      pokud je true, k získání požadovaných dat budou použity další pooly proxy;
      parametr lze použít, pokud je současně nastaveno mnoho úloh, což vede k občasným chybám rate-limit a/nebo site_unreachable

    • url
      Typ: string

      url stránky
      povinné pole
      absolutní URL stránky pro snímek
      poznámka: pokud URL, kterou zde uvedete, vrátí stavový kód 404 nebo uvedená hodnota není platná URL, v poli odpovědi získáte "error_message":"Screenshot is empty"

Odpovědi
  • 200
    Typ: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo
    • cost
      Typ: number | null Formát: double

      celkové náklady na úlohy, USD

    • status_code
      Typ: integer | null

      obecný kód stavu úplný seznam kódů odpovědí najdete zde

    • status_message
      Typ: string | null

      obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

    • tasks
      Typ: array (object | null)[] | null

      pole úloh

      • Typ: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
        • cost
          Typ: number | null Formát: double

          celkové náklady na úlohy, USD

        • data
          Typ: object | null

          obsahuje stejné parametry, které jste zadali v požadavku POST

          • propertyName
            Typ: object | null
        • id
          Typ: string | null

          identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

        • path
          Typ: array (string | null)[] | null

          cesta URL

        • result
          Typ: array (object | null)[] | null

          pole výsledků

          • crawl_progress
            Typ: string | null

            stav relace procházení
            možné hodnoty: in_progress, finished

          • error_message
            Typ: string | null

            zpráva o chybě
            pokud zadaná url vrací stavový kód 404 nebo není platnou URL, získáte "error_message":"Screenshot is empty"
            pokud nedojde k chybě, bude hodnota null

          • items
            Typ: array (object | null)[] | null

            pole položek

            • image
              Typ: string | null

              snímek obrazovky požadované stránky
              adresa URL snímku obrazovky stránky v úložišti DataForSEO
              poznámka: snímek obrazovky uložený v úložišti DataForSEO zůstává dostupný pouze jeden den po odeslání požadavku

          • items_count
            Typ: integer | null Formát: int64

            počet položek v poli výsledků

        • result_count
          Typ: integer | null Formát: int64

          počet prvků v poli result

        • status_code
          Typ: integer | null

          stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

        • status_message
          Typ: string | null

          informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

        • time
          Typ: string | null

          doba provedení, sekundy

    • tasks_count
      Typ: integer | null Formát: int64

      počet úloh v poli tasks

    • tasks_error
      Typ: integer | null Formát: int64

      počet úloh v poli tasks vrácených s chybou

    • time
      Typ: string | null

      celková doba provádění, sekundy

    • version
      Typ: string | null

      aktuální verze API

    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    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
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

OnPage API Page Screenshot