DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Cascade de l'API OnPage
La chronologie de chargement d'une url crawlée — ce qui a été demandé, dans quel ordre et combien de temps chaque élément a pris. 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. Utilisez-la pour expliquer une page lente ; pour un audit de performance noté, utilisez plutôt post_dataforseo_on_page_lighthouse_live_json. 💰 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 page
champ obligatoire
indiquez les pages pour lesquelles vous souhaitez recevoir des données de chronométrage
- Type: object | null · Response36Afe1097B20_OnPageWaterfallResponseInfo200
- 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_OnPageWaterfallTaskInfo
- 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
- connectionType: integer | null
_time temps de connexion à un serveur
le temps nécessaire jusqu'à l'établissement de la connexion avec un serveur (en millisecondes) - domType: integer | null
_complete temps de chargement des ressources
le temps nécessaire jusqu'au téléchargement de la page et de toutes ses sous-ressources (en millisecondes) - downloadType: integer | null
_time temps nécessaire à un navigateur pour recevoir une réponse (en millisecondes)
- durationType: integer | null
_time temps total nécessaire à un navigateur pour recevoir une réponse complète d'un serveur (en millisecondes)
- fetchType: integer | null
_end temps nécessaire pour terminer le téléchargement de la ressource HTML
le temps dont le navigateur a besoin pour terminer le téléchargement d'une page - fetchType: integer | null
_start temps nécessaire pour commencer le téléchargement de la ressource HTML
le temps dont le navigateur a besoin pour commencer le téléchargement d'une page - pageType: string | null
_url URL de la page
- requestType: integer | null
_sent _time temps d'envoi d'une requête à un serveur
le temps nécessaire jusqu'à l'envoi de la requête à un serveur (en millisecondes) - resourcesType: array (object | null)[] | null
temps spécifiques à chaque ressource
contient des tableaux distincts avec les temps de chaque ressource trouvée sur la page- durationType: integer | null
_time temps total nécessaire à un navigateur pour recevoir une réponse complète d'un serveur (en millisecondes)
- fetchType: integer | null
_end temps nécessaire pour terminer le téléchargement de la ressource HTML
le temps dont le navigateur a besoin pour terminer le téléchargement d'une page - fetchType: integer | null
_start temps nécessaire pour commencer le téléchargement de la ressource HTML
le temps dont le navigateur a besoin pour commencer le téléchargement d'une page - initiatorType: string | null
initiateur de la ressource
- isType: boolean | null
_render _blocking indique si la ressource bloque le rendu
- locationType: object | null · Response36Afe1097B20_OnPageResourceLocationInfo
emplacement de la ressource dans le document
paramètres définissant l'emplacement de la ressource spécifique dans le HTML du document- lineType: integer | null
numéro de ligne
le numéro de la ligne sur laquelle se trouve la ressource - offsetType: integer | null
_left position dans la ligne
le nombre de caractères de la ligne avant la ressource ;
parfois appelé colonne
Remarque : compte à partir de 1, c'est-à-dire que si la ressource n'a aucun caractère à sa gauche, la valeur sera 1 - offsetType: integer | null
_top position dans le document
le nombre total de caractères entre la ressource et le début du HTML
- resourceType: string | null
_type - urlType: string | null
URL de la ressource
- timeType: integer | null
_to _interactive métrique Time To Interactive (TTI)
le temps nécessaire jusqu'à ce que l'utilisateur puisse interagir avec une page (en millisecondes) - timeType: integer | null
_to _secure _connection temps d'établissement d'une connexion sécurisée
le temps nécessaire jusqu'à l'établissement de la connexion sécurisée avec un serveur (en millisecondes) - waitingType: integer | null
_time
- itemsType: integer | null Format: int64
_count nombre d'éléments du tableau de résultats
- 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/waterfall \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "08101204-0696-0216-0000-644a7b21a48a",
"url": "https://dataforseo.com/tag/broken-links"
}
]'
{
"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
},
"items_count": null,
"items": [
{
"page_url": null,
"time_to_interactive": null,
"dom_complete": null,
"connection_time": null,
"time_to_secure_connection": null,
"request_sent_time": null,
"waiting_time": null,
"download_time": null,
"duration_time": null,
"fetch_start": null,
"fetch_end": null,
"resources": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}