DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Microdata de l'API OnPage
Valide les données structurées d'une url crawlée. Lit un crawl terminé : il lui faut l'id renvoyé par post_dataforseo_on_page_submit et il renvoie crawl_progress ainsi qu'un crawl_status composé de max_crawl_pages, pages_in_queue et pages_crawled — vérifiez ces valeurs avant de faire confiance à un petit résultat, car un crawl encore en cours a simplement moins à signaler. ⚠️ La page doit avoir fait partie du crawl : demander une URL qui n'en faisait pas partie renvoie status_code 40406, Requested page was not submitted for crawling, dans un HTTP 200. Augmentez max_crawl_pages ou définissez start_url sur l'appel de soumission si la page voulue manque. 💰 Gratuit en amont : interroger un crawl terminé ne coûte rien, seul le crawl lui-même est facturé.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.012.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array (object | null)[]
- idType: string
- tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse - urlType: string
URL de la ressource
champ obligatoire
vous pouvez obtenir cette URL dans la réponse du point de terminaison Pages
exemple :https://dataforseo.com/apis
- Type: object | null · Response36Afe1097B20_OnPageMicrodataResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_OnPageMicrodataTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: array (object | null)[] | null
tableau de résultats
- crawlType: string | null
_progress état de la session d'exploration
valeurs possibles :in_progress,finished - crawlType: object | null · Response36Afe1097B20_CrawlStatusInfo
_status détails de la session d'exploration
- maxType: integer | null Format: int64
_crawl _pages nombre maximal de pages à explorer indique la limite max_crawl_pages que vous avez définie lors de la configuration d'une tâche
- pagesType: integer | null Format: int64
_crawled nombre de pages explorées
- pagesType: integer | null Format: int64
_in _queue nombre de pages actuellement dans la file d'exploration
- itemsType: array (object | null)[] | null
tableau items
- inspectionType: object | null · Response36Afe1097B20_MicrodataInspectionInfo
_info informations relatives à la validation des microdonnées
- fieldsType: array (object | null)[] | null
champs de microdonnées
un tableau d'objets contenant les champs de données liés au type de microdonnées donné- fieldsType: array (object | null)[] | null
champs de microdonnées
un tableau d'objets contenant les champs de données liés au type de microdonnées donné- fieldsType: array (object | null)[] | null
champs de microdonnées
un tableau d'objets contenant les champs de données liés au type de microdonnées donné - nameType: string | null
nom du champ
nom du champ de données - testType: object | null · Response36Afe1097B20_MessageInfo
_results résultats du test de validation des microdonnées
résultats du test de microdonnées de sous-type contenant les erreurs détectées et les messages associés- levelType: string | null
niveau d'erreur peut prendre les valeurs suivantes : fatal, error, warning, info
- messageType: string | null
message associé à une erreur message fournissant les détails de l'erreur détectée
- typesType: array (string | null)[] | null
liste des types de microdonnées
- valueType: string | null
valeur de microdonnées valeur de microdonnées spécifiée sur une page web cible
- nameType: string | null
nom du champ
nom du champ de données - testType: object | null · Response36Afe1097B20_MessageInfo
_results résultats du test de validation des microdonnées
résultats du test de microdonnées de sous-type contenant les erreurs détectées et les messages associés- levelType: string | null
niveau d'erreur peut prendre les valeurs suivantes : fatal, error, warning, info
- messageType: string | null
message associé à une erreur message fournissant les détails de l'erreur détectée
- typesType: array (string | null)[] | null
liste des types de microdonnées
- valueType: string | null
valeur de microdonnées valeur de microdonnées spécifiée sur une page web cible
- typesType: array (string | null)[] | null
- typeType: string | null
type d'élément
- itemsType: integer | null Format: int64
_count nombre d'éléments du tableau de résultats
- testType: object | null · Response36Afe1097B20_TestSummary
_summary résultats du test de validation des microdonnées
- errorType: integer | null
nombre d'erreurs graves de microdonnées
- fatalType: integer | null
nombre d'erreurs fatales de microdonnées
- infoType: integer | null
nombre d'indicateurs d'information de microdonnées
- warningType: integer | null
nombre d'avertissements de microdonnées
- resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
la version actuelle de l'API
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
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]"
}
]
}
]
}
]
}