DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Mikrodata OnPage API
Validuje strukturovaná data na jedné procházené url. Načítá dokončené procházení, takže potřebuje id z post_dataforseo_on_page_submit a vrací crawl_progress a crawl_status s hodnotami max_crawl_pages, pages_in_queue a pages_crawled — zkontrolujte je, než budete malému výsledku důvěřovat, protože procházení, které stále běží, má prostě méně co hlásit. ⚠️ Stránka musí být součástí procházení: požadavek na URL, která nebyla, vrací status_code 40406, Requested page was not submitted for crawling, uvnitř HTTP 200. Zvyšte max_crawl_pages nebo nastavte start_url při odeslání, pokud požadovaná stránka chybí. 💰 Zdarma na straně upstreamu: dotaz na dokončené procházení nic nestojí, platí se jen samotné procházení.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.012.
- Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: array (object | null)[]
- idTyp: string
- tagTyp: string | null
uživatelem definovaný identifikátor úlohy
volitelné pole
limit znaků je 255
tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
zadanou hodnotutagnajdete v objektudataodpovědi - urlTyp: string
URL zdroje
povinné pole
tuto URL můžete získat v odpovědi endpointu Pages
příklad:https://dataforseo.com/apis
- Typ: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_OnPageMicrodataTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- crawlTyp: string | null
_progress stav relace procházení
možné hodnoty:in_progress,finished - crawlTyp: object | null · Response36Afe1097B20_CrawlStatusInfo
_status podrobnosti relace procházení
- maxTyp: integer | null Formát: int64
_crawl _pages maximální počet stránek k procházení udává limit max_crawl_pages, který jste zadali při nastavování úlohy
- pagesTyp: integer | null Formát: int64
_crawled počet procházených stránek
- pagesTyp: integer | null Formát: int64
_in _queue počet stránek, které jsou aktuálně ve frontě procházení
- itemsTyp: array (object | null)[] | null
pole položek
- inspectionTyp: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info informace související s validací mikrodat
- fieldsTyp: array (object | null)[] | null
pole mikrodat
pole objektů obsahujících datová pole související s určitým typem mikrodat- fieldsTyp: array (object | null)[] | null
pole mikrodat
pole objektů obsahujících datová pole související s určitým typem mikrodat- fieldsTyp: array (object | null)[] | null
pole mikrodat
pole objektů obsahujících datová pole související s určitým typem mikrodat - nameTyp: string | null
název pole
název datového pole - testTyp: object | null · Response36Afe1097B20_MessageInfo
_results výsledky testu validace mikrodat
výsledky testu mikrodat podtypu, které obsahují zjištěné chyby a související zprávy- levelTyp: string | null
úroveň chyby může nabývat následujících hodnot: fatal, error, warning, info
- messageTyp: string | null
zpráva spojená s chybou zpráva poskytující podrobnosti o zjištěné chybě
- typesTyp: array (string | null)[] | null
seznam typů mikrodat
- valueTyp: string | null
hodnota mikrodat hodnota mikrodat uvedená na cílové webové stránce
- nameTyp: string | null
název pole
název datového pole - testTyp: object | null · Response36Afe1097B20_MessageInfo
_results výsledky testu validace mikrodat
výsledky testu mikrodat podtypu, které obsahují zjištěné chyby a související zprávy- levelTyp: string | null
úroveň chyby může nabývat následujících hodnot: fatal, error, warning, info
- messageTyp: string | null
zpráva spojená s chybou zpráva poskytující podrobnosti o zjištěné chybě
- typesTyp: array (string | null)[] | null
seznam typů mikrodat
- valueTyp: string | null
hodnota mikrodat hodnota mikrodat uvedená na cílové webové stránce
- typesTyp: array (string | null)[] | null
- typeTyp: string | null
typ prvku
- itemsTyp: integer | null Formát: int64
_count počet položek v poli výsledků
- testTyp: object | null · Response36Afe1097B20_TestSummary
_summary výsledky testu validace mikrodat
- errorTyp: integer | null
počet závažných chyb mikrodat
- fatalTyp: integer | null
počet fatálních chyb mikrodat
- infoTyp: integer | null
počet informačních příznaků mikrodat
- warningTyp: integer | null
počet varování mikrodat
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
aktuální verze API
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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]"
}
]
}
]
}
]
}