DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage-Aufgaben einstellen
Startet einen Crawl von target und gibt eine Aufgaben-id in tasks[0].id zurück – diese ID ist der Griff, den jedes andere Werkzeug dieser Familie braucht, also behalten Sie sie. max_crawl_pages begrenzt den Crawl, start_url, max_crawl_depth, priority_urls und crawl_delay formen ihn, und store_raw_html entscheidet, ob post_dataforseo_on_page_raw_html später etwas ausliefern kann. 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. ⚠️ Dies ist nicht das übliche Submit/Fetch-Paar: Der Crawl ist eine Sitzung, die ein Dutzend anderer Werkzeuge dann per ID abfragt. Fragen Sie get_dataforseo_on_page_summary ab, bis crawl_progress finished lautet; ein Crawl von example.com mit einer Seite dauerte deutlich unter einer Minute.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.003.
- 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)[]
- acceptTyp: string | null
_language 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 werden Seiten mit"type":"brokenim Antwort-Array zurückgegeben - allowTyp: boolean | null
_subdomains Seiten auf Subdomains einbeziehen
Optionales Feld
Setzen Sie dieses Feld auftrue, wenn Sie alle Subdomains einer Ziel-Website crawlen möchten
Standardwert:false - allowedTyp: array string[] | null
_subdomains zu crawlende Subdomains
Optionales Feld
Geben Sie die Subdomains an, die Sie crawlen möchten
Beispiel:["blog.site.com", "my.site.com", "shop.site.com"]
Hinweis: Um diesen Parameter zu verwenden, sollte der Parameterallow_subdomainsauffalsegesetzt sein;
andernfalls wird der Inhalt des Feldesallowed_subdomainsignoriert und die Ergebnisse werden für alle Subdomains zurückgegeben - browserTyp: string | null
_preset Voreinstellung für Bildschirmparameter des Browsers
Optionales Feld
Wenn Sie dieses Feld verwenden, müssen Siebrowser_screen_width,browser_screen_height,browser_screen_scale_factornicht angeben Mögliche Werte:desktop,mobile,tabletDie Voreinstellungdesktopwendet die folgenden Werte an:browser_screen_width: 1920browser_screen_height: 1080browser_screen_scale_factor: 1Die Voreinstellungmobilewendet die folgenden Werte an:browser_screen_width: 390browser_screen_height: 844browser_screen_scale_factor: 3Die Voreinstellungtabletwendet die folgenden Werte an:browser_screen_width: 1024browser_screen_height: 1366browser_screen_scale_factor: 2
Hinweis: Um diesen Parameter zu verwenden, setzen Sieenable_javascriptoderenable_browser_renderingauftrue - browserTyp: integer | null
_screen _height 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 Siebrowser_presetnicht angeben, da es ignoriert wird;
Hinweis: Um diesen Parameter zu verwenden, setzen Sieenable_javascriptoderenable_browser_renderingauftrueMindestwert in Pixeln:240
Maximalwert in Pixeln:9999 - browserTyp: number | null
_screen _scale _factor 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 Siebrowser_presetnicht angeben, da es ignoriert wird;
Hinweis: Um diesen Parameter zu verwenden, setzen Sieenable_javascriptoderenable_browser_renderingauftrueMindestwert:0.5
Maximalwert:3 - browserTyp: integer | null Format: int64
_screen _width 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 Siebrowser_presetnicht angeben, da es ignoriert wird;
Hinweis: Um diesen Parameter zu verwenden, setzen Sieenable_javascriptoderenable_browser_renderingauftrueMindestwert in Pixeln:240
Maximalwert in Pixeln:9999 - calculateTyp: boolean | null
_keyword _density Keyword-Dichte für die Zieldomain berechnen
Optionales Feld
Setzen Sie dieses Feld auftrue, wenn Sie die Keyword-Dichte für Website-Seiten berechnen möchten
Standardwert:false
Hinweis: Bei Verwendung dieses Parameters fallen zusätzliche Kosten an; mehr über die Kosten von Aufgaben mit diesem Parameter erfahren Sie in unserem Hilfeartikel
Sobald das Crawling abgeschlossen ist, können Sie Keyword-Dichtewerte über den Endpunkt Keyword Density abrufen - checkTyp: boolean | null
_spell - checkTyp: array string[] | null
_spell _exceptions von der Rechtschreibprüfung ausgeschlossene Wörter
Optionales Feld
Geben Sie die Wörter an, die Sie von der Rechtschreibprüfung ausschließen möchten
Maximale Wortlänge: 100 Zeichen
Maximale Anzahl der Wörter: 1000
Beispiel:"SERP", "minifiers", "JavaScript" - checkTyp: string | null
_spell _language Sprache der Rechtschreibprüfung
Optionales Feld
Unterstützte Sprachen: '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'
Hinweis: Wenn keine Sprache angegeben ist, wird sie automatisch anhand des Seiteninhalts festgelegt - checksTyp: object | null
_threshold benutzerdefinierte Schwellenwerte für Prüfungen
Optionales Feld
Sie können benutzerdefinierte Schwellenwerte für die Parameter imchecks-Objekt der Antworten der OnPage API angeben;
Hinweis: Nur ganzzahlige Schwellenwerte können geändert werden;
Beispielsweise sind die Parameterhigh_loading_timeundlarge_page_sizestandardmäßig auf 3 Sekunden bzw. 1 Megabyte gesetzt;
Wenn Sie diese Schwellenwerte auf 1 Sekunde und 1000 kbytes ändern möchten, verwenden Sie das folgende Snippet:"checks_threshold": {<br>"high_loading_time": 1,<br>"large_page_size": 1000<br>}
Anpassbare Parameter mit Standardwerten:"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"- propertyTyp: integer | null Format: int64
Name Signed 64-bit integers (long type).
- crawlTyp: integer | null
_delay Verzögerung zwischen Zugriffen, ms
Optionales Feld
die benutzerdefinierte Verzögerung zwischen den Crawler-Zugriffen auf den Server
Standardwert:2000 - crawlTyp: boolean | null
_sitemap _only nur Seiten crawlen, die im Sitemap angegeben sind
Optionales Feld
auftruesetzen, wenn nur die im Sitemap angegebenen Seiten gecrawlt werden sollen
wenn Sie diesen Parameter auftruesetzen undcustom_sitemapnicht angeben, wird das Standard-Sitemap gecrawlt
Standardwert:false
Hinweis: um diesen Parameter zu verwenden, sollterespect_sitemapauftruestehen - customTyp: string | null
_js benutzerdefiniertes JavaScript
Optionales Feld
Hinweis: Die Ausführungszeit für das hier eingegebene Skript sollte höchstens 700 ms betragen; mit dem folgenden JS-Snippet können Sie beispielsweise prüfen, ob die Website Google Tag Manager alsscr-Attribut enthält:let meta = { haveGoogleAnalytics: false, haveTagManager: false };rnfor (var i = 0; i < document.scripts.length; i++) {rn let src = document.scripts[i].getAttribute("src");rn if (src != undefined) {rn if (src.indexOf("analytics.js") >= 0)rn meta.haveGoogleAnalytics = true;rntif (src.indexOf("gtm.js") >= 0)rn meta.haveTagManager = true;rn }rn}rnmeta;Der zurückgegebene Wert hängt davon ab, was Sie in diesem Feld angegeben haben. Wenn Sie beispielsweise das folgende Skript angeben:meta = {}; meta.url = document.URL; meta.test = 'test'; meta;
erhalten Sie als Antwort die folgenden Daten:"custom_js_response": {<br>"url": "https://dataforseo.com/",<br>"test": "test"<br>}
Hinweis: das eingegebene Skript darf höchstens 2000 Zeichen lang sein - customTyp: string | null
_robots _txt benutzerdefinierte robots.txt-Einstellungen
Optionales Feld
Beispiel:Disallow: /directory1/ - customTyp: string | null
_sitemap URL des benutzerdefinierten Sitemaps
Optionales Feld
die URL der Seite, auf der das alternative Sitemap liegt
Hinweis: um diesen Parameter zu verwenden, sollterespect_sitemapauftruestehen - customTyp: string | null
_user _agent 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) - disableTyp: boolean | null
_cookie _popup Cookie-Popup deaktivieren
Optionales Feld
auftruesetzen, wenn das Popup zur Einholung der Cookie-Einwilligung des Nutzers deaktiviert werden soll;
Standardwert:false - disableTyp: array string[] | null
_page _checks bestimmte Seitenprüfungen an der Ausführung hindern
Optionales Feld
geben Sie bestimmtechecksan, um ihre Ausführung und ihre Auswirkung auf denonpage_scorezu verhindern. Beispiel:"disable_page_checks": ["is_5xx_code", "is_4xx_code"] - disableTyp: array string[] | null
_sitewide _checks bestimmte websiteweite Prüfungen an der Ausführung hindern
Optionales Feld
geben Sie die folgendenchecksan, um ihre Ausführung auf der Websitetargetzu verhindern:"test_page_not_found""test_canonicalization""test_https_redirect""test_directory_browsing"Beispiel:"disable_sitewide_checks": ["test_directory_browsing", "test_page_not_found"]weitere Informationen in unserem Help Center - disallowedTyp: array string[] | null
_subdomains Subdomains, die nicht gecrawlt werden sollen
Optionales Feld
geben Sie Subdomains an, die nicht gecrawlt werden sollen
Beispiel:["status.site.com", "docs.site.com"]
Hinweis: um diesen Parameter zu verwenden, muss der Parameterallow_subdomainsauftruegesetzt sein - enableTyp: boolean | null
_browser _rendering Browser-Rendering emulieren, um Core Web Vitals zu messen
Optionales Feld
mit diesem Parameter können Sie beim Laden einer Webseite einen Browser emulieren;enable_browser_renderinglädt Stile, Bilder, Schriftarten, Animationen, Videos und andere Ressourcen einer Seite;
Standardwert:false
auftruesetzen, um Core Web Vitals (FID, CLS, LCP) in der Antwort zu erhalten;
wenn Sie dieses Feld verwenden, müssen die Parameterenable_javascriptundload_resourcesauftruegesetzt sein
Hinweis: bei Verwendung dieses Parameters fallen zusätzliche Kosten an; weitere Informationen zu den Kosten von Aufgaben mit diesem Parameter finden Sie in unserem Hilfeartikel; die Kosten lassen sich auf der Preisseite berechnen - enableTyp: boolean | null
_content _parsing - enableTyp: boolean | null
_javascript JavaScript auf einer Seite laden
Optionales Feld
auftruesetzen, wenn die auf einer Seite verfügbaren Skripte geladen werden sollen
Standardwert:false
Hinweis: bei Verwendung dieses Parameters fallen zusätzliche Kosten an; weitere Informationen zu den Kosten von Aufgaben mit diesem Parameter finden Sie in unserem Hilfeartikel; die Kosten lassen sich auf der Preisseite berechnen - enableTyp: boolean | null
_www _redirect _check prüfen, ob die Domain die www-Weiterleitung implementiert hat
Optionales Feld
auftruesetzen, um zu prüfen, ob die angefragte Domain die Weiterleitung von www zu non-www oder von non-www zu www implementiert hat;
Standardwert:false - enableTyp: boolean | null
_xhr XMLHttpRequest auf einer Seite aktivieren
Optionales Feld
auftruesetzen, wenn unser Crawler Daten von einem Webserver über das XMLHttpRequest-Objekt anfordern soll
Standardwert:false;wenn Sie dieses Feld verwenden, mussenable_javascriptauftruegesetzt sein; - forceTyp: boolean | null
_sitewide _checks websiteweite Prüfungen beim Crawlen einer einzelnen Seite aktivieren
Optionales Feld
auftruesetzen, um beim Crawlen einer einzelnen Seite Daten zu websiteweiten Prüfungen zu erhalten;
Standardwert:false - loadTyp: boolean | null
_resources Ressourcen laden
Optionales Feld
auftruesetzen, wenn Bilder, Stylesheets, Skripte und fehlerhafte Ressourcen geladen werden sollen
Standardwert:false
Hinweis: bei Verwendung dieses Parameters fallen zusätzliche Kosten an; weitere Informationen zu den Kosten von Aufgaben mit diesem Parameter finden Sie in unserem Hilfeartikel; die Kosten lassen sich auf der Preisseite berechnen - maxTyp: integer | null
_crawl _depth Crawl-Tiefe
Optionales Feld
die Verlinkungstiefe der zu crawlenden Seiten;
beispielsweise ist die Startseite des Crawls Ebene 0, Seiten mit Links von dieser Seite sind Ebene 1 usw. - maxTyp: integer
_crawl _pages Limit für gecrawlte Seiten
Pflichtfeld
die Anzahl der Seiten, die auf der angegebenen Domain gecrawlt werden
Hinweis:
wenn Siemax_crawl_pagesauf 1 setzen undstart_urlnicht angeben oder darin eine Startseite festlegen, werden die folgenden websiteweiten Prüfungen deaktiviert:test_canonicalization,enable_www_redirect_check,test_hidden_server_signature,test_page_not_found,test_directory_browsing,test_https_redirect
um sie dennoch zu aktivieren, setzen Sieforce_sitewide_checksauftruewenn Siemax_crawl_pagesauf 1 setzen und eine anderestart_urlals eine Startseite angeben, werden alle websiteweiten Prüfungen deaktiviert;
um sie dennoch zu aktivieren, setzen Sieforce_sitewide_checksauftrue - pingbackTyp: string | null
_url Benachrichtigungs-URL für eine abgeschlossene Aufgabe
Optionales Feld
Wenn eine Aufgabe abgeschlossen ist, benachrichtigen wir Sie per GET-Anfrage an die von Ihnen angegebene URL
Sie können die Zeichenfolge ‘$id’ als$id-Variable und ‘$tag’ als URL-kodierte$tag-Variable verwenden. Wir setzen die erforderlichen Werte vor dem Senden der Anfrage.
Beispiel:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Hinweis: Sonderzeichen inpingback_urlwerden URL-kodiert;
d. h. das Zeichen#wird zu%23kodiert - priorityTyp: array string[] | null
_urls URLs, die unter Umgehung der Warteschlange gecrawlt werden
Optionales Feld
in diesem Array angegebene URLs werden zuerst gecrawlt, unter Umgehung der Crawl-Warteschlange;
Hinweis: Sie sollten die absolute URL angeben;
Sie können bis zu 20 URLs angeben;
alle URLs im Array müssen zur Domaintargetgehören;
Subdomains werden ignoriert, sofern der Parameterallow_subdomainsnicht auftruegesetzt istBeispiel:"priority_urls": [<br>"https://dataforseo.com/apis/serp-api",<br>"https://dataforseo.com/contact"<br>] - respectTyp: boolean | null
_sitemap Sitemap beim Crawlen berücksichtigen
Optionales Feld
auftruesetzen, wenn beim Crawlen die Reihenfolge der im primären Sitemap angegebenen Seiten befolgt werden soll;
Standardwert:false
Hinweis: beitrueentspricht der Wertclick_depthin der API-Antwort0;
das Feldmax_crawl_depthder Anfrage wird ignoriert; die Anzahl der zu crawlenden Seiten können Sie mit dem Parametermax_crawl_pagesangeben - returnTyp: boolean | null
_despite _timeout Daten zu Seiten trotz Timeout-Fehler zurückgeben
Optionales Feld
beitruewerden Daten zu Seiten bereitgestellt, die innerhalb von 120 Sekunden nicht geladen werden konnten und mit einem Timeout-Fehler geantwortet haben;
Standardwert:false - robotsTyp: string | null
_txt _merge _mode robots.txt-Einstellungen zusammenführen oder überschreiben
Optionales Feld
mögliche Werte:merge,override;
aufoverridesetzen, wenn Crawling-Beschränkungen der Website und andere robots.txt-Einstellungen ignoriert werden sollen
Standardwert:merge;
Hinweis: beioverrideden Parametercustom_robots_txtangeben - startTyp: string | null
_url die erste zu crawlende URL
Optionales Feld
Hinweis: Sie sollten eine absolute URL angeben
wenn Sie eine einzelne Seite crawlen möchten, geben Sie ihre URL in diesem Feld an und setzen Sie zusätzlich den Parametermax_crawl_pagesauf1
Sie können auch den Live-Instant-Pages-Endpunkt verwenden, um seitenspezifische Daten zu erhalten - storeTyp: boolean | null
_raw _html - supportTyp: boolean | null
_cookies Cookies auf gecrawlten Seiten unterstützen
Optionales Feld
auftruesetzen, um Cookies beim Crawlen der Seiten zu unterstützen
Standardwert:false - switchTyp: boolean | null
_pool Proxy-Pool wechseln
Optionales Feld
Beitruewerden zusätzliche Proxy-Pools zum Abrufen der angeforderten Daten verwendet;
Der Parameter kann verwendet werden, wenn viele Aufgaben gleichzeitig gesetzt werden, was zu gelegentlichenrate-limit- und/odersite_unreachable-Fehlern führt - tagTyp: string | null
Benutzerdefinierte Aufgaben-ID
Optionales Feld
Zeichenlimit: 255
Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen
Den angegebenen Werttagfinden Sie imdata-Objekt der Antwort - targetTyp: string
Ziel-Domain
Pflichtfeld
der Domainname muss ohnehttps://undwww.angegeben werden
wenn Sie die Seiten-URL angeben, werden die Ergebnisse für die in der URL enthaltene Domain zurückgegeben - validateTyp: boolean | null
_micromarkup
- Typ: object | null · Response36Afe1097B20_OnPageTaskPostResponseInfo200
- 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_OnPageTaskPostTaskInfo
- 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: object | null
Array von Ergebnissen
in diesem Fall ist der Wertnull - 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/on_page/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"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"
}
]'
{
"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": null
}
]
}