DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API: microdata
Valideert de gestructureerde gegevens op één gecrawlde url. Leest een voltooide crawl en heeft dus de id uit post_dataforseo_on_page_submit nodig; retourneert crawl_progress plus een crawl_status van max_crawl_pages, pages_in_queue en pages_crawled – controleer die voordat je een klein resultaat vertrouwt, want een crawl die nog loopt heeft eenvoudigweg minder te melden. ⚠️ De pagina moet deel hebben uitgemaakt van de crawl: een URL die dat niet was, retourneert status_code 40406, Requested page was not submitted for crawling, binnen een HTTP 200. Verhoog max_crawl_pages of stel start_url in bij de submit-aanroep als de gewenste pagina ontbreekt. 💰 Gratis upstream: een voltooide crawl bevragen kost niets, alleen de crawl zelf.
Prijsreferentie
- Metering: Gerapporteerde responskosten.
- Referentieschatting per verzoek: USD 0.012.
- Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.
Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.
- Type: array (object | null)[]
- idType: string
- tagType: string | null
door gebruiker gedefinieerde taak-ID
optioneel veld
de tekenslimiet is 255
je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
de opgegeven waardetagvind je in hetdata-object van de respons - urlType: string
bron-URL
verplicht veld
deze URL vindt u in de respons van het endpoint Pages
voorbeeld:https://dataforseo.com/apis
- Type: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- Type: number | null Formaat: doublecost
Totale kosten van taken, USD
- Type: integer | nullstatus
_code algemene statuscode de volledige lijst met responscodes vindt u hier
- Type: string | nullstatus
_message algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier
- Type: array (object | null)[] | nulltasks
array van taken
- Type: object | null · Response36Afe1097B20_OnPageMicrodataTaskInfo
- costType: number | null Formaat: double
Totale kosten van taken, USD
- dataType: object | null
Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven
- propertyType: object | null
Name
- idType: string | null
taak-id eenduidige taak-id in ons systeem in UUID-indeling
- pathType: array (string | null)[] | null
URL-pad
- resultType: array (object | null)[] | null
array van resultaten
- crawlType: string | null
_progress status van de crawlsessie
mogelijke waarden:in_progress,finished - crawlType: object | null · Response36Afe1097B20_CrawlStatusInfo
_status details van de crawlsessie
- maxType: integer | null Formaat: int64
_crawl _pages maximaal aantal te crawlen pagina's geeft de max_crawl_pages-limiet aan die u hebt opgegeven bij het instellen van een taak
- pagesType: integer | null Formaat: int64
_crawled aantal gecrawlde pagina's
- pagesType: integer | null Formaat: int64
_in _queue aantal pagina's dat momenteel in de crawlwachtrij staat
- itemsType: array (object | null)[] | null
items-array
- inspectionType: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info informatie over microdata-validatie
- fieldsType: array (object | null)[] | null
microdatavelden
een array met objecten die gegevensvelden bevatten die bij het betreffende microdatatype horen- fieldsType: array (object | null)[] | null
microdatavelden
een array met objecten die gegevensvelden bevatten die bij het betreffende microdatatype horen- fieldsType: array (object | null)[] | null
microdatavelden
een array met objecten die gegevensvelden bevatten die bij het betreffende microdatatype horen - nameType: string | null
veldnaam
naam van het gegevensveld - testType: object | null · Response36Afe1097B20_MessageInfo
_results resultaten van de microdata-validatietest
resultaten van de microdatatest voor subtypen met gedetecteerde fouten en bijbehorende berichten- levelType: string | null
foutniveau kan de volgende waarden aannemen: fatal, error, warning, info
- messageType: string | null
bericht dat bij een fout hoort bericht met details over de gedetecteerde fout
- typesType: array (string | null)[] | null
lijst met microdatatypen
- valueType: string | null
microdatawaarde microdatawaarde die op een doelwebpagina is opgegeven
- nameType: string | null
veldnaam
naam van het gegevensveld - testType: object | null · Response36Afe1097B20_MessageInfo
_results resultaten van de microdata-validatietest
resultaten van de microdatatest voor subtypen met gedetecteerde fouten en bijbehorende berichten- levelType: string | null
foutniveau kan de volgende waarden aannemen: fatal, error, warning, info
- messageType: string | null
bericht dat bij een fout hoort bericht met details over de gedetecteerde fout
- typesType: array (string | null)[] | null
lijst met microdatatypen
- valueType: string | null
microdatawaarde microdatawaarde die op een doelwebpagina is opgegeven
- typesType: array (string | null)[] | null
- typeType: string | null
elementtype
- itemsType: integer | null Formaat: int64
_count aantal items in de resultatenarray
- testType: object | null · Response36Afe1097B20_TestSummary
_summary testresultaten van de microdata-validatie
- errorType: integer | null
aantal ernstige microdatafouten
- fatalType: integer | null
aantal fatale microdatafouten
- infoType: integer | null
aantal microdata-informatieflags
- warningType: integer | null
aantal microdatawaarschuwingen
- resultType: integer | null Formaat: int64
_count Aantal elementen in de result-array
- statusType: integer | null
_code statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier
- statusType: string | null
_message informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier
- timeType: string | null
Uitvoeringstijd in seconden
- Type: integer | null Formaat: int64tasks
_count Het aantal taken in de tasks-array
- Type: integer | null Formaat: int64tasks
_error Het aantal taken in de tasks-array dat met een fout is geretourneerd
- Type: string | nulltime
totale uitvoeringstijd, seconden
- Type: string | nullversion
De huidige versie van de API
application/json - 400
Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
- 401
Een geldige Felo-API-sleutel is vereist.
- 402
Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
- 403
Het account mag deze bewerking niet uitvoeren.
- 429
Een verzoek- of bestedingslimiet is bereikt.
- 502
De dienst kon het verzoek niet voltooien.
- 503
De API of factureringsdienst is tijdelijk niet beschikbaar.
- 504
Er is een time-out opgetreden bij het verwerken van het verzoek.
- default
Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken
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]"
}
]
}
]
}
]
}