DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Recherches principales
Les mots-clés au volume le plus élevé dans une localisation, sans filtre par mot-clé de départ ni par site. 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. C'est l'extrémité découverte de la famille : utilisez-le lorsqu'il n'y a pas encore de mot-clé de départ, puis affinez avec post_dataforseo_labs_google_keyword_ideas_live.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.1356.
- 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_in,match,not_match,ilike,not_ilike,like,not_like
vous pouvez utiliser l'opérateur%aveclikeetnot_like, ainsi qu'ilikeetnot_ilike, pour correspondre à toute chaîne de zéro ou plusieurs caractères
exemple :["keyword_info.search_volume",">",0][["keyword_info.search_volume","in",[0,1000]],
"and",
["keyword_info.competition_level","=","LOW"]][["keyword_info.search_volume",">",100],
"and",
[["keyword_info.cpc","<",0.5],
"or",["keyword_info.high_top_of_page_bid","<=",0.5]]]
pour plus d'informations sur les filtres, consultez Dataforseo Labs - Filters ou ce guide du centre d'aideObjet vide - ignoreType: boolean | null
_synonyms ignorer les mots-clés très similaires
champ facultatif
s'il est défini surtrue, seuls les mots-clés principaux sont renvoyés, tous les mots-clés très similaires sont 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_keyword_info,keyword_info_normalized_with_clickstreametkeyword_info_normalized_with_bingdans la réponse
valeur par défaut :false
avec ce paramètre activé, le double du prix de base par requête vous sera facturéen savoir plus sur le calcul des métriques basées sur le clickstream dans cet article du centre d'aide
- includeType: boolean | null
_serp _info inclure les données SERP pour chaque mot-clé
champ facultatif
s'il est défini surtrue, nous renverrons un tableauserp_infocontenant les données SERP (nombre de résultats de recherche, URL pertinente et fonctionnalités SERP) pour chaque mot-clé de la réponse
valeur par défaut :false - languageType: string | null
_code code de langue
champ obligatoire si vous n'indiquez paslanguage_name
Remarque : il est obligatoire de spécifierlanguage_nameoulanguage_code
vous pouvez obtenir la liste des emplacements disponibles avec leurlanguage_codeen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
exemple :en - languageType: string
_name nom complet de la langue
champ obligatoire si vous n'indiquez paslanguage_code
Remarque : il est obligatoire de spécifierlanguage_nameoulanguage_code
vous pouvez obtenir la liste des emplacements disponibles avec leurlanguage_nameen effectuant une requête distincte vershttps://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
exemple :English - limitType: integer | null
le nombre maximal de mots-clés renvoyés
champ facultatif
remarque : vous pouvez obtenir plus de 1000 résultats en utilisant leoffset_tokenfourni dans la réponse à chaque requête suivante
valeur par défaut :1000
valeur maximale :1000 - locationType: integer
_code code d'emplacement
champ obligatoire si vous n'indiquez paslocation_name
Remarque : il est obligatoire de spécifierlocation_nameoulocation_code
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
exemple :2840 - locationType: string
_name nom complet de l'emplacement
champ obligatoire si vous n'indiquez paslocation_code
Remarque : il est obligatoire de spécifierlocation_nameoulocation_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
exemple :United Kingdom - offsetType: integer | null
décalage dans le tableau de résultats des mots-clés renvoyés
champ facultatif
valeur par défaut :0
si vous spécifiez la valeur10, les dix premiers mots-clés du tableau de résultats seront omis et les données seront fournies pour les mots-clés suivants
Remarque : nous recommandons d'utiliser ce paramètre uniquement pour récupérer jusqu'à 10 000 résultats
pour récupérer plus de 10 000 résultats, utilisez plutôtoffset_token. - offsetType: string | null
_token jeton de décalage pour les requêtes suivantes
champ facultatif
fourni dans le champ identique de la réponse à chaque requête ;
utilisez ce paramètre pour éviter les délais d'attente lorsque vous essayez d'obtenir plus de 10 000 résultats en une seule requête ;
en indiquant la valeur unique deoffset_tokendu tableau de réponse, vous obtiendrez les résultats suivants de la tâche initiale ;
les valeurs deoffset_tokensont uniques pour chaque tâche suivante
Remarque : si leoffset_tokenest indiqué dans la requête, tous les autres paramètres à l'exception delimitne seront pas pris en compte lors du traitement de la tâche.
en savoir plus sur ce paramètre dans notre centre d'aide - 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 définir un type de tri
exemple :["keyword_info.competition,desc"]
règle par défaut :["keyword_info.search_volume,desc"]
notez que 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 :["keyword_info.search_volume,desc","keyword_info.cpc,desc"] - 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
- Type: object | null · Response36Afe1097B20_DataforseoLabsGoogleTopSearchesLiveResponseInfo200
- 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_DataforseoLabsGoogleTopSearchesLiveTaskInfo
- 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
contient des mots-clés et les données associées
- avgType: object | null · Response36Afe1097B20_AvgBacklinksInfo
_backlinks _info données de backlinks du mot-clé renvoyé
cet objet fournit le nombre moyen de backlinks, de pages de référence et de domaines, ainsi que les valeurs de classement moyennes parmi les 10 pages web les mieux classées organiquement pour le mot-clé- backlinksType: number | null
nombre moyen de backlinks
- dofollowType: number | null
nombre moyen de liens dofollow
- lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - mainType: number | null
_domain _rank - rankType: number | null
- referringType: number | null
_domains nombre moyen de domaines référents
- referringType: number | null
_main _domains nombre moyen de domaines principaux référents
- referringType: number | null
_pages nombre moyen de pages référentes
- seType: string | null
_type type de moteur de recherche
- clickstreamType: object | null · Response36Afe1097B20_ClickstreamKeywordInfo
_keyword _info données clickstream du mot-clé renvoyé
pour obtenir des résultats pour ce champ, le paramètreinclude_clickstream_datadoit être défini surtrue- ageType: object | null
_distribution - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- genderType: object | null
_distribution - propertyType: integer | null Format: int64
Name Signed 64-bit integers (long type).
- lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - monthlyType: array (object | null)[] | null
_searches recherches mensuelles
représente le nombre (approximatif) de recherches sur cette idée de mot-clé (tel que disponible sur les douze derniers mois), ciblées sur les emplacements géographiques spécifiés- monthType: integer | null
mois
- searchType: integer | null
_volume taux moyen mensuel de volume de recherche
- yearType: integer | null
année
- searchType: integer | null Format: int64
_volume taux moyen de volume de recherche mensuel
représente le nombre (approximatif) de recherches pour l'idée de mot-clé donnée sur google.com
- keywordType: string | null
idée de mot-clé renvoyée
- keywordType: object | null · Response36Afe1097B20_KeywordInfo
_info données de mot-clé de l'idée de mot-clé renvoyée
- categoriesType: array integer[] | null
- competitionType: number | null
concurrence
représente la quantité relative de concurrence associée au mot-clé donné. Cette valeur est basée sur les données Google Ads et peut être comprise entre 0 et 1 (inclus) - competitionType: string | null
_level - cpcType: number | null
coût par clic
représente le coût par clic moyen (USD) historiquement payé pour le mot-clé - highType: number | null
_top _of _page _bid enchère maximale pour que l'annonce s'affiche en haut de la première page
indique la valeur supérieure à environ 80 % des enchères les plus basses pour lesquelles des annonces ont été diffusées (d'après les statistiques Google Ads pour les annonceurs)
la valeur peut varier selon la localisation indiquée dans une requête POST - lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - lowType: number | null
_top _of _page _bid enchère minimale pour que l'annonce s'affiche en haut de la première page
indique la valeur supérieure à environ 20 % des enchères les plus basses pour lesquelles des annonces ont été diffusées (d'après les statistiques Google Ads pour les annonceurs)
la valeur peut varier selon la localisation indiquée dans une requête POST - monthlyType: array (object | null)[] | null
_searches recherches mensuelles
représente le nombre (approximatif) de recherches sur cette idée de mot-clé (tel que disponible sur les douze derniers mois), ciblées sur les emplacements géographiques spécifiés- monthType: integer | null
mois
- searchType: integer | null
_volume taux moyen mensuel de volume de recherche
- yearType: integer | null
année
- seType: string | null
_type type de moteur de recherche
- searchType: integer | null Format: int64
_volume taux moyen de volume de recherche mensuel
représente le nombre (approximatif) de recherches pour l'idée de mot-clé donnée sur google.com - searchType: object | null · Response36Afe1097B20_SearchVolumeTrend
_volume _trend variations de la tendance du volume de recherche
représente la variation en pourcentage du volume de recherche par rapport à la période précédente- monthlyType: integer | null
variation en pourcentage du volume de recherche par rapport au mois précédent
- quarterlyType: integer | null
variation en pourcentage du volume de recherche par rapport au trimestre précédent
- yearlyType: integer | null
variation en pourcentage du volume de recherche par rapport à l'année précédente
- keywordType: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _bing contient le volume de recherche du mot-clé normalisé par le volume de recherche Bing
- isType: boolean | null
_normalized les informations de mot-clé sont normalisées si vrai, les valeurs sont normalisées avec les données Bing
- lastType: string | null
_updated _time date et heure de mise à jour de l'ensemble de données au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2019-11-15 12:57:46 +00:00
- monthlyType: array (object | null)[] | null
_searches taux mensuels de volume de recherche tableau d'objets avec les taux de volume de recherche pour un mois donné d'une année
- monthType: integer | null
mois
- searchType: integer | null
_volume taux moyen mensuel de volume de recherche
- yearType: integer | null
année
- searchType: integer | null
_volume taux actuel de volume de recherche d'un mot-clé
- keywordType: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo
_info _normalized _with _clickstream contient le volume de recherche du mot-clé normalisé par les données clickstream
- isType: boolean | null
_normalized les informations de mot-clé sont normalisées si vrai, les valeurs sont normalisées avec les données Bing
- lastType: string | null
_updated _time date et heure de mise à jour de l'ensemble de données au format UTC : “yyyy-mm-dd hh-mm-ss +00:00” exemple : 2019-11-15 12:57:46 +00:00
- monthlyType: array (object | null)[] | null
_searches taux mensuels de volume de recherche tableau d'objets avec les taux de volume de recherche pour un mois donné d'une année
- monthType: integer | null
mois
- searchType: integer | null
_volume taux moyen mensuel de volume de recherche
- yearType: integer | null
année
- searchType: integer | null
_volume taux actuel de volume de recherche d'un mot-clé
- keywordType: object | null · Response36Afe1097B20_KeywordProperties
_properties informations complémentaires sur le mot-clé
- coreType: string | null
_keyword mot-clé principal d'un groupe
contient le mot-clé principal d'un groupe déterminé par l'algorithme de regroupement de synonymes
si la valeur estnull, notre base de données ne contient aucun mot-clé que l'algorithme correspondant pourrait identifier comme synonyme dekeyword - detectedType: string | null
_language langue détectée du mot-clé
indique la langue du mot-clé telle qu'identifiée par notre système - isType: boolean | null
_another _language la langue détectée du mot-clé diffère de la langue définie
sitrue, la langue définie dans la requête ne correspond pas à la langue déterminée par notre système pour un mot-clé donné - keywordType: integer | null
_difficulty difficulté de se classer dans les 10 premiers résultats organiques pour un mot-clé
indique la probabilité d'entrer dans les 10 premiers résultats organiques pour un mot-clé sur une échelle logarithmique de 0 à 100 ;
calculée en analysant, entre autres paramètres, les profils de liens des 10 premières pages des SERP ;
en savoir plus sur la métrique dans ce guide du centre d'aide - seType: string | null
_type type de moteur de recherche
- synonymType: string | null
_clustering _algorithm l'algorithme utilisé pour identifier les synonymes
valeurs possibles :keyword_metrics- indique l'algorithme basé sur les paramètreskeyword_infotext_processing- indique l'algorithme basé sur le texte
si la valeur estnull, notre base de données ne contient aucun mot-clé que l'algorithme correspondant pourrait identifier comme synonyme dekeyword - wordsType: integer | null Format: int64
_count nombre de mots dans le mot-clé
indique de combien de mots se compose le mot-clé
- languageType: string | null
_code code de langue dans un tableau POST
- locationType: integer | null
_code code de localisation dans un tableau POST
- seType: string | null
_type type de moteur de recherche
- searchType: object | null · Response36Afe1097B20_SearchIntentInfo
_intent _info - foreignType: array (string | null)[] | null
_intent intentions de recherche complémentaires
valeurs possibles :informational,navigational,commercial,transactional - lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - mainType: string | null
_intent intention de recherche principale
valeurs possibles :informational,navigational,commercial,transactional - seType: string | null
_type type de moteur de recherche
- serpType: object | null · Response36Afe1097B20_SerpInfo
_info données SERP
la valeur seranullsi vous n'avez pas défini le champinclude_serp_infosurtruedans le tableau POST ou s'il n'existe aucune donnée SERP pour ce mot-clé dans notre base de données- checkType: string | null
_url URL directe vers les résultats du moteur de recherche
vous pouvez l'utiliser pour vérifier que nous fournissons des résultats précis - lastType: string | null
_updated _time date et heure de mise à jour des données du mot-clé
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - previousType: string | null
_updated _time date et heure précédant la plus récente mise à jour des données SERP
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-10-15 12:57:46 +00:00 - seType: integer | null Format: int64
_results _count nombre de résultats de recherche pour le mot-clé renvoyé
- seType: string | null
_type type de moteur de recherche
- serpType: array (string | null)[] | null
_item _types types de résultats de recherche dans la SERP
contient les types de résultats de recherche (items) trouvés dans la SERP
types d'éléments possibles :answer_box,app,carousel,multi_carousel,featured_snippet,google_flights,google_reviews,third_party_reviews,google_posts,images,jobs,knowledge_graph,local_pack,hotels_pack,map,organic,paid,people_also_ask,related_searches,people_also_search,shopping,top_stories,twitter,video,events,mention_carousel,recipes,top_sights,scholarly_articles,popular_products,podcasts,questions_and_answers,find_results_on,stocks_box,visual_stories,commercial_units,local_services,google_hotels,math_solver,currency_box,product_considerations,found_on_web,short_videos,refine_products,explore_brands,perspectives,discussions_and_forums,compare_sites,courses,ai_overview;
remarque : les résultats réels ne seront renvoyés que pour les élémentsorganic,paid,featured_snippetetlocal_pack
- 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
- locationType: integer | null
_code code de localisation dans un tableau POST
- offsetType: integer | null
valeur de décalage actuelle
- offsetType: string | null
_token jeton de décalage pour les requêtes suivantes
vous pouvez utiliser la chaîne fournie dans ce champ pour obtenir les résultats suivants de la tâche initiale ;
remarque : les valeurs d'offset_tokensont uniques pour chaque tâche suivante - seType: string | null
_type type de moteur de recherche
- 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/top_searches/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_name": "English",
"location_code": 2840,
"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,
"location_code": null,
"language_code": null,
"total_count": null,
"items_count": null,
"offset": null,
"offset_token": null,
"items": [
{
"se_type": null,
"keyword": null,
"location_code": null,
"language_code": null,
"keyword_info": "[Max Depth Exceeded]",
"keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
"keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
"clickstream_keyword_info": "[Max Depth Exceeded]",
"keyword_properties": "[Max Depth Exceeded]",
"serp_info": "[Max Depth Exceeded]",
"avg_backlinks_info": "[Max Depth Exceeded]",
"search_intent_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}