DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
SERP-API: Seiten-Screenshot
Gibt einen gerenderten Screenshot einer Suchergebnisseite bei Google zurück. Gibt keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count und items zurück. 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.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.02.
- 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.
- Typ: array (object | null)[]
- browserTyp: string | null
_preset Voreinstellung der Browserauflösung
optionales Feld
Browservoreinstellung für einen bestimmten Gerätetyp
kann folgende Werte annehmen:desktop,tablet,mobile
Hinweis: Standardmäßig entspricht die Browservoreinstellung dem in der POST-Anfrage angegebenen Gerätetyp - browserTyp: integer | null
_screen _height Höhe der Browserauflösung
optionales Feld
kann im folgenden Bereich angegeben werden:240-9999
Standardwert fürdesktop: 1080
Standardwert fürmobile: 844
Standardwert fürtable: 1366 - browserTyp: number | null
_screen _scale _factor Browser-Skalierungsfaktor
optionales Feld
kann im folgenden Bereich angegeben werden:0.5-3
Standardwert fürdesktop: 1
Standardwert fürmobile: 3
Standardwert fürtable: 2 - browserTyp: integer | null Format: int64
_screen _width Breite der Browserauflösung
optionales Feld
kann im folgenden Bereich angegeben werden:240-9999
Standardwert fürdesktop: 1920
Standardwert fürmobile: 390
Standardwert fürtable: 1024 - pageTyp: integer | null
Anzahl der SERP-Seiten
optionales Feld
wenndepthin der entsprechenden Task-POST-Anfrage mehr als 10 Ergebnisse (oder 1 SERP-Seite) umfasst, geben Sie die Anzahl der SERP-Seiten für den Screenshot an;
Standardwert:1 - taskTyp: string
_id
- Typ: object | null · Response36Afe1097B20_SerpScreenshotResponseInfo200
- Typ: number | null Format: doublecost
Gesamtkosten der Aufgaben in USD
- Typ: integer | nullstatus
_code allgemeiner Statuscode die vollständige Liste der Antwortcodes finden Sie hier
- Typ: string | nullstatus
_message allgemeine Informationsmeldung die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier
- Typ: array (object | null)[] | nulltasks
Array von Aufgaben
- Typ: object | null · Response36Afe1097B20_SerpScreenshotTaskInfo
- costTyp: number | null Format: double
Gesamtkosten der Aufgaben in USD
- dataTyp: object | null
Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben
- propertyTyp: object | null
Name
- idTyp: string | null
Aufgaben-ID eindeutige Aufgaben-ID in unserem System im UUID-Format
- pathTyp: array (string | null)[] | null
URL-Pfad
- resultTyp: array (object | null)[] | null
Array von Ergebnissen
- itemsTyp: array (object | null)[] | null
Array der Einträge
- imageTyp: 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
- itemsTyp: integer | null Format: int64
_count Anzahl der Einträge im Ergebnis-Array
- resultTyp: integer | null Format: int64
_count Anzahl der Elemente im Ergebnis-Array
- statusTyp: integer | null
_code Statuscode der Aufgabe von DataForSEO erzeugt, kann im folgenden Bereich liegen: 10000-60000 die vollständige Liste der Antwortcodes finden Sie hier
- statusTyp: string | null
_message Informationsmeldung der Aufgabe die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier
- timeTyp: string | null
Ausführungszeit in Sekunden
- Typ: integer | null Format: int64tasks
_count Die Anzahl der Aufgaben im tasks-Array
- Typ: integer | null Format: int64tasks
_error Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden
- Typ: string | nulltime
Gesamtausführungszeit, Sekunden
- Typ: string | nullversion
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
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/screenshot \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"task_id": "06211235-0696-0139-1000-36727fbd3c90",
"browser_screen_scale_factor": 0.5
}
]'
{
"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": [
{
"items_count": null,
"items": [
{
"image": null
}
]
}
]
}
]
}