DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Pages pertinentes
Quelles pages d'un site target génèrent ses classements, classées par le trafic qu'elles apportent. Paginé avec limit, offset et offset_token ; utilisez le jeton au-delà des premières pages. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. Utilisez-le pour repérer les pages à défendre ou à développer. Pour les mots-clés associés, utilisez post_dataforseo_labs_google_kw_for_site_live ; pour les pages qui génèrent des liens plutôt que des classements, post_dataforseo_backlinks_domain_pages_summary_live.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.015.
- 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)[]
- filtersType: array (object | null)[] | null
tableau de paramètres de filtrage des résultats
champ facultatif
vous pouvez ajouter plusieurs filtres à la fois (8 filtres maximum)
vous devez définir un opérateur logiqueand,orentre les conditions
les opérateurs suivants sont pris en charge :regex,not_regex,<,<=,>,>=,=,<>,in,not_inexemple :
["metrics.paid.count",">",0][["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]][[""metrics.organic.count",">",50"],
"and",
[["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
pour plus d'informations sur les filtres, consultez Dataforseo Labs - Filters ou ce guide du centre d'aideObjet vide - historicalType: string | null
_serp _mode mode de collecte des données
champ facultatif
vous pouvez utiliser ce champ pour filtrer les résultats ;
types de filtrage possibles :live— renvoie les métriques des SERP dans lesquelles letargetindiqué a actuellement des résultats de classement ;lost— renvoie les métriques des SERP dans lesquelles letargetindiqué avait auparavant des résultats de classement, mais n'en avait pas lors de la dernière vérification ;all— renvoie les métriques des deux types de SERP.
valeur par défaut :live - ignoreType: boolean | null
_synonyms ignorer les mots-clés très similaires
champ facultatif
si défini surtrue, seuls les mots-clés principaux seront renvoyés ; tous les mots-clés très similaires seront exclus ;
valeur par défaut :false - includeType: boolean | null
_clickstream _data inclure ou exclure les données des métriques basées sur le clickstream dans le résultat
champ facultatif
si le paramètre est défini surtrue, vous recevrez les champsclickstream_etv,clickstream_gender_distributionetclickstream_age_distributionavec les données de clickstream dans la réponse
valeur par défaut :false
avec ce paramètre activé, le prix de la requête vous sera facturé au doubleen savoir plus sur le calcul des métriques basées sur le clickstream dans cet article du centre d'aide
- itemType: array string[] | null
_types afficher les résultats par type d'élément
champ facultatif
indique le type de résultats de recherche inclus dans la réponseRemarque : si le tableau
item_typescontient des types d'élément différents deorganic, les résultats seront triés selon le premier type d'élément du tableau ; vous ne pourrez pas trier ni filtrer les résultats par les types de résultats de recherche non inclus dans la réponse ;valeurs possibles :
["organic", "paid", "featured_snippet", "local_pack"]
valeur par défaut :["organic", "paid"] - languageType: string | null
_code code de langue
champ facultatif
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_name
vous pouvez obtenir la liste des langues disponibles avec leurlanguage_codeen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignorez ce champ pour obtenir les résultats de toutes les langues disponibles
exemple :en - languageType: string | null
_name nom complet de la langue
champ facultatif
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlanguage_code
vous pouvez obtenir la liste des langues disponibles avec leurlanguage_nameen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignorez ce champ pour obtenir les résultats de toutes les langues disponibles
exemple :English - limitType: integer | null
le nombre maximal de pages renvoyées
champ facultatif
valeur par défaut :100
valeur maximale :1000 - locationType: integer | null
_code code d'emplacement
champ facultatif
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_name
vous pouvez obtenir la liste des emplacements disponibles avec leurlocation_codeen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignorez ce champ pour obtenir les résultats de tous les emplacements disponibles
exemple :2840 - locationType: string | null
_name nom complet de l'emplacement
champ facultatif
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_code
vous pouvez obtenir la liste des emplacements disponibles avec leurlocation_nameen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
ignorez ce champ pour obtenir les résultats de tous les emplacements disponibles
exemple :United Kingdom - offsetType: integer | null
décalage dans le tableau de résultats des pages renvoyées
champ facultatif
valeur par défaut :0
si vous spécifiez la valeur10, les dix premières pages du tableau de résultats seront omises et les données seront fournies pour les pages suivantes - orderType: array string[] | null
_by règles de tri des résultats
champ facultatif
vous pouvez utiliser les mêmes valeurs que dans le tableaufilterspour trier les résultats
types de tri possibles :asc- les résultats seront triés par ordre croissantdesc- les résultats seront triés par ordre décroissant
vous devez utiliser une virgule pour spécifier un type de tri
exemple :["metrics.paid.etv,asc"]
Remarque : vous pouvez définir au maximum trois règles de tri dans une seule requête
vous devez utiliser une virgule pour séparer plusieurs règles de tri
exemple :["metrics.organic.etv,desc","metrics.paid.count,asc"]règle par défaut :
["metrics.organic.count,desc"]
Remarque : si le tableauitem_typescontient des types d'élément différents deorganic, les résultats seront triés selon le premier type d'élément du tableau - 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 - targetType: string
domaine
champ obligatoire
le nom de domaine du site web cible
le domaine doit être indiqué sanshttps://niwww.
- Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleRelevantPagesLiveResponseInfo200
- 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_DataforseoLabsGoogleRelevantPagesLiveTaskInfo
- 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
- itemsType: array (object | null)[] | null
pages pertinentes et données associées
- metricsType: object | null
classements et métriques de trafic pour la page pertinente
- propertyType: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
Name - clickstreamType: object | null
_age _distribution - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- clickstreamType: number | null Format: double
_etv volume de trafic estimé basé sur les données de clickstream
calculé comme le produit des valeurs de click-through-rate et de volume de recherche clickstream de tous les mots-clés pour lesquels le domaine est classé
pour obtenir les résultats de ce champ, le paramètreinclude_clickstream_datadoit être défini surtrue
en savoir plus sur le calcul de la métrique dans cet article du centre d'aide - clickstreamType: object | null
_gender _distribution - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- countType: integer | null Format: int64
nombre total de SERP organiques contenant le domaine ou le sous-domaine
- estimatedType: number | null
_paid _traffic _cost coût estimé de la conversion du trafic de recherche organique en trafic payant
représente le coût mensuel estimé (USD) de diffusion d'annonces pour tous les mots-clés de la catégorie pour lesquels le domaine ou sous-domaine est classé
la métrique est calculée comme le produit des valeursetvorganiques etcpcpayantes et indique le coût de génération du volume estimé de trafic organique mensuel via la publicité PPC dans Google Search
en savoir plus sur le calcul de la métrique dans cet article du centre d'aide - etvType: number | null
volume de trafic estimé
trafic organique mensuel estimé vers le domaine ou sous-domaine
calculé comme le produit des valeurs de CTR (click-through-rate) et de volume de recherche de tous les mots-clés de la catégorie pour lesquels le domaine ou sous-domaine est classé
en savoir plus sur le calcul de la métrique dans cet article du centre d'aide - isType: integer | null
_down le classement a baissé
indique combien d'éléments classés de la cible indiquée ont baissé - isType: integer | null
_lost éléments classés perdus
indique combien d'éléments classés de la cible indiquée étaient auparavant présents dans les SERP, mais n'ont pas été trouvés lors de la dernière vérification - isType: integer | null
_new nombre de nouveaux éléments classés
indique combien de nouveaux éléments classés ont été trouvés pour la cible indiquée - isType: integer | null
_up le classement a augmenté
indique combien d'éléments classés de la cible indiquée ont augmenté - posType: integer | null
_1 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°1
- posType: integer | null
_11 _20 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°11-20
- posType: integer | null
_2 _3 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°2-3
- posType: integer | null
_21 _30 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°21-30
- posType: integer | null
_31 _40 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°31-40
- posType: integer | null
_4 _10 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°4-10
- posType: integer | null
_41 _50 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°41-50
- posType: integer | null
_51 _60 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°51-60
- posType: integer | null
_61 _70 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°61-70
- posType: integer | null
_71 _80 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°71-80
- posType: integer | null
_81 _90 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°81-90
- posType: integer | null
_91 _100 nombre de SERP organiques où le domaine ou sous-domaine occupe la position n°91-100
- pageType: string | null
_address URL absolue de la page pertinente
- seType: string | null
_type type de moteur de recherche
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - languageType: string | null
_code code de langue dans un tableau POST
s'il n'y a pas de données, la valeur estnull - locationType: integer | null
_code code d'emplacement dans un tableau POST
s'il n'y a pas de données, la valeur estnull - seType: string | null
_type type de moteur de recherche
- targetType: string | null
domaine cible dans un tableau POST
- totalType: integer | null Format: int64
_count quantité totale de résultats de notre base de données correspondant à votre requête
- 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/dataforseo_labs/google/relevant_pages/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "amazon.com",
"language_name": "English",
"location_code": 2840,
"filters": [
[
"metrics.organic.pos_1",
"<>",
0
],
"or",
[
"metrics.organic.pos_2_3",
"<>",
0
]
],
"limit": 3
}
]'
{
"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": [
{
"se_type": null,
"target": null,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"items": [
{
"se_type": null,
"page_address": null,
"metrics": null
}
]
}
]
}
]
}