v0.2.0-beta

OpenAPI 3.1.0

OnPage API: Seiten-Screenshot

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operationen

post/v1/beta/dataforseo/on_page/page_screenshot

OnPage API: Seiten-Screenshot

Rendert eine beliebige url und gibt einen Screenshot zurück; full_page_screenshot gilt für die gesamte Scrollhöhe, browser_screen_width und browser_screen_height setzen den Viewport. Eigenständig – kein Crawl nötig. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück. ⚠️ Ein Bild ist ein großes Tool-Ergebnis, noch bevor ein Agent damit etwas anfangen kann; fragen Sie nur dann einen Screenshot ab, wenn das Visuelle der Punkt ist, und verwenden Sie post_dataforseo_on_page_content_parsing_live, wenn es der Text ist.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.0051.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen abgerechneten Kundenbetrag anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

application/json

Typ: array (object | null)[]
- accept_language
  Typ: string | null
  
  Sprach-Header für den Zugriff auf die Website
  Optionales Feld
  Alle Locale-Formate werden unterstützt (xx, xx-XX, xxx-XX usw.)
  Hinweis: Wenn Sie diesen Parameter nicht angeben, können einige Websites den Zugriff verweigern; in diesem Fall erhalten Sie "error_message":"Screenshot is empty" im Antwort-Array
- browser_preset
  Typ: string | null
  
  Voreinstellung für Bildschirmparameter des Browsers
  Optionales Feld
  Wenn Sie dieses Feld verwenden, müssen Sie browser_screen_width, browser_screen_height, browser_screen_scale_factor nicht angeben
  
  Mögliche Werte:
  desktop, mobile, tablet
  
  Die Voreinstellung desktop wendet die folgenden Werte an:
  
  browser_screen_width: 1920
  browser_screen_height: 1080
  browser_screen_scale_factor: 1
  
  Die Voreinstellung mobile wendet die folgenden Werte an:
  
  browser_screen_width: 390
  browser_screen_height: 844
  browser_screen_scale_factor: 3
  
  Die Voreinstellung tablet wendet die folgenden Werte an:
  
  browser_screen_width: 1024
  browser_screen_height: 1366
  browser_screen_scale_factor: 2
  
  Hinweis: In diesem Endpunkt sind die Parameter enable_browser_rendering, enable_javascript, load_resources und enable_xhr immer aktiviert.
- browser_screen_height
  Typ: integer | null
  
  Bildschirmhöhe des Browsers
  Optionales Feld
  Sie können eine benutzerdefinierte Bildschirmhöhe des Browsers festlegen, um einen Audit für ein bestimmtes Gerät durchzuführen;
  Wenn Sie dieses Feld verwenden, müssen Sie browser_preset nicht angeben, da es ignoriert wird;
  
  Mindestwert in Pixeln: 240
  Maximalwert in Pixeln: 9999
- browser_screen_scale_factor
  Typ: number | null
  
  Skalierungsfaktor des Browserbildschirms
  Optionales Feld
  Sie können ein benutzerdefiniertes Auflösungsverhältnis des Browsers festlegen, um einen Audit für ein bestimmtes Gerät durchzuführen;
  Wenn Sie dieses Feld verwenden, müssen Sie browser_preset nicht angeben, da es ignoriert wird;
  
  Mindestwert: 0.5
  Maximalwert: 3
- browser_screen_width
  Typ: integer | null Format: int64
  
  Bildschirmbreite des Browsers
  Optionales Feld
  Sie können eine benutzerdefinierte Bildschirmbreite des Browsers festlegen, um einen Audit für ein bestimmtes Gerät durchzuführen;
  Wenn Sie dieses Feld verwenden, müssen Sie browser_preset nicht angeben, da es ignoriert wird;
  
  Mindestwert in Pixeln: 240
  Maximalwert in Pixeln: 9999
- custom_user_agent
  Typ: string | null
  
  benutzerdefinierter User-Agent
  Optionales Feld
  Benutzerdefinierter User-Agent für das Crawlen einer Website
  Beispiel: 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
  Standardwert: Mozilla/5.0 (compatible; RSiteAuditor)
- disable_cookie_popup
  Typ: boolean | null
  
  Cookie-Popup deaktivieren
  Optionales Feld
  Setzen Sie dieses Feld auf true, wenn Sie das Popup zur Cookie-Zustimmung des Nutzers deaktivieren möchten;
  Standardwert:
  false
- full_page_screenshot
  Typ: boolean | null
  
  Screenshot der gesamten Seite aufnehmen
  Optionales Feld
  Setzen Sie dieses Feld auf false, wenn Sie nur den vor dem Scrollen sichtbaren Teil der Seite erfassen möchten
  Standardwert: true
- ip_pool_for_scan
  Typ: string | null
  
  Proxy-Pool
  Optionales Feld
  Sie können einen Standort für den Proxy-Pool wählen, der zum Abrufen der angeforderten Daten verwendet wird;
  Der Parameter kann verwendet werden, wenn Seiteninhalte an einem der Standorte nicht erreichbar sind, was zu gelegentlichen site_unreachable-Fehlern führt
  Mögliche Werte: us, de
- switch_pool
  Typ: boolean | null
  
  Proxy-Pool wechseln
  Optionales Feld
  Bei true werden zusätzliche Proxy-Pools zum Abrufen der angeforderten Daten verwendet;
  Der Parameter kann verwendet werden, wenn viele Aufgaben gleichzeitig gesetzt werden, was zu gelegentlichen rate-limit- und/oder site_unreachable-Fehlern führt
- url
  Typ: string
  
  Seiten-URL
  Pflichtfeld
  Absolute URL der Seite, die aufgenommen werden soll
  Hinweis: Wenn die hier angegebene URL den Statuscode 404 zurückgibt oder der angegebene Wert keine gültige URL ist, erhalten Sie "error_message":"Screenshot is empty" im Antwort-Array

Antworten

200
Typ: object | null · Response36Afe1097B20_OnPagePageScreenshotResponseInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer | null

allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

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

Array von Aufgaben

Typ: object | null · Response36Afe1097B20_OnPagePageScreenshotTaskInfo
cost
Typ: number | null Format: double

Gesamtkosten der Aufgaben in USD

data
Typ: object | null

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

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

Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format

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

URL-Pfad

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

Array von Ergebnissen

crawl_progress
Typ: string | null

Status der Crawling-Sitzung
mögliche Werte: in_progress, finished

error_message
Typ: string | null

Fehlermeldung
wenn die von Ihnen angegebene url den Statuscode 404 zurückgibt oder keine gültige URL ist, erhalten Sie "error_message":"Screenshot is empty"
tritt kein Fehler auf, ist der Wert null

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

Array der Einträge

image
Typ: string | null

Screenshot der angeforderten Seite
URL des Seiten-Screenshots im DataForSEO-Speicher
Hinweis: Der im DataForSEO-Speicher gespeicherte Seiten-Screenshot bleibt nur einen Tag nach der Anfrage zugänglich

items_count
Typ: integer | null Format: int64

Anzahl der Einträge im Ergebnis-Array

result_count
Typ: integer | null Format: int64

Anzahl der Elemente im Ergebnis-Array

status_code
Typ: integer | null

Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier

status_message
Typ: string | null

Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier

time
Typ: string | null

Ausführungszeit in Sekunden

tasks_count
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer | null Format: int64

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

time
Typ: string | null

Gesamtausführungszeit, Sekunden

version
Typ: string | null

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

application/json

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

Schema anzeigen

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

Erfolgreicher Vorgang

OnPage API: Seiten-Screenshot

AuthentifizierungRequired

DataForSEO

OnPage API: Seiten-Screenshot

Preisreferenz