DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API: Mikrodaten
Validiert die strukturierten Daten auf einer gecrawlten url. Liest einen abgeschlossenen Crawl und benötigt daher die id aus post_dataforseo_on_page_submit; gibt crawl_progress sowie einen crawl_status aus max_crawl_pages, pages_in_queue und pages_crawled zurück – prüfen Sie diese, bevor Sie einem kleinen Ergebnis vertrauen, denn ein noch laufender Crawl hat einfach weniger zu berichten. ⚠️ Die Seite muss Teil des Crawls gewesen sein: Eine URL, die es nicht war, liefert status_code 40406, Requested page was not submitted for crawling, innerhalb eines HTTP 200. Erhöhen Sie max_crawl_pages oder setzen Sie start_url beim Submit-Aufruf, wenn die gewünschte Seite fehlt. 💰 Upstream kostenlos: das Abfragen eines abgeschlossenen Crawls kostet nichts, nur der Crawl selbst.
Preisreferenz
- Abrechnung: Gemeldete Antwortkosten.
- Referenzschätzung pro Anfrage: USD 0.012.
- 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)[]
- idTyp: string
- 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 - urlTyp: string
Ressourcen-URL
Pflichtfeld
Diese URL erhalten Sie in der Antwort des Endpunkts Pages
Beispiel:https://dataforseo.com/apis
- Typ: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- 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_OnPageMicrodataTaskInfo
- 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
- crawlTyp: string | null
_progress Status der Crawling-Sitzung
mögliche Werte:in_progress,finished - crawlTyp: object | null · Response36Afe1097B20_CrawlStatusInfo
_status Details der Crawling-Sitzung
- maxTyp: integer | null Format: int64
_crawl _pages maximale Anzahl der zu crawlenden Seiten gibt das max_crawl_pages-Limit an, das Sie beim Festlegen einer Aufgabe gesetzt haben
- pagesTyp: integer | null Format: int64
_crawled Anzahl der gecrawlten Seiten
- pagesTyp: integer | null Format: int64
_in _queue Anzahl der Seiten, die sich derzeit in der Crawl-Warteschlange befinden
- itemsTyp: array (object | null)[] | null
Array der Einträge
- inspectionTyp: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info Informationen zur Microdata-Validierung
- fieldsTyp: array (object | null)[] | null
Mikrodatenfelder
ein Array von Objekten mit Datenfeldern zum jeweiligen Mikrodatentyp- fieldsTyp: array (object | null)[] | null
Mikrodatenfelder
ein Array von Objekten mit Datenfeldern zum jeweiligen Mikrodatentyp- fieldsTyp: array (object | null)[] | null
Mikrodatenfelder
ein Array von Objekten mit Datenfeldern zum jeweiligen Mikrodatentyp - nameTyp: string | null
Feldname
Name des Datenfelds - testTyp: object | null · Response36Afe1097B20_MessageInfo
_results Ergebnisse des Mikrodaten-Validierungstests
Ergebnisse des Mikrodaten-Tests für Untertypen mit erkannten Fehlern und zugehörigen Meldungen- levelTyp: string | null
Fehlerstufe kann folgende Werte annehmen: fatal, error, warning, info
- messageTyp: string | null
Mit einem Fehler verbundene Meldung Meldung mit Details zum erkannten Fehler
- typesTyp: array (string | null)[] | null
Liste der Mikrodatentypen
- valueTyp: string | null
Mikrodatenwert auf einer Zielwebseite angegebener Mikrodatenwert
- nameTyp: string | null
Feldname
Name des Datenfelds - testTyp: object | null · Response36Afe1097B20_MessageInfo
_results Ergebnisse des Mikrodaten-Validierungstests
Ergebnisse des Mikrodaten-Tests für Untertypen mit erkannten Fehlern und zugehörigen Meldungen- levelTyp: string | null
Fehlerstufe kann folgende Werte annehmen: fatal, error, warning, info
- messageTyp: string | null
Mit einem Fehler verbundene Meldung Meldung mit Details zum erkannten Fehler
- typesTyp: array (string | null)[] | null
Liste der Mikrodatentypen
- valueTyp: string | null
Mikrodatenwert auf einer Zielwebseite angegebener Mikrodatenwert
- typesTyp: array (string | null)[] | null
- typeTyp: string | null
Elementtyp
- itemsTyp: integer | null Format: int64
_count Anzahl der Einträge im Ergebnis-Array
- testTyp: object | null · Response36Afe1097B20_TestSummary
_summary Testergebnisse der Microdata-Validierung
- errorTyp: integer | null
Anzahl schwerwiegender Microdata-Fehler
- fatalTyp: integer | null
Anzahl fataler Microdata-Fehler
- infoTyp: integer | null
Anzahl der Microdata-Informationsflags
- warningTyp: integer | null
Anzahl der Microdata-Warnungen
- 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/microdata \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "02241700-1535-0216-0000-034137259bc1",
"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,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"test_summary": {
"fatal": null,
"error": null,
"warning": null,
"info": null
},
"items_count": null,
"items": [
{
"type": null,
"inspection_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}