Configurer les tâches ‘DataForSEO Trends Subregion Interests’ en temps réel
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches ‘DataForSEO Trends Subregion Interests’ en temps réel
Où se concentre l'intérêt pour un mot-clé, ventilé par sous-région dans location_code. 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. Pour savoir qui plutôt qu'où, utilisez post_dataforseo_keywords_trends_demography_live.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.0024.
- Multiplicateur de référence client : 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)[]
- dateType: string | null
_from date de début de l'intervalle de temps
champ facultatif
si vous n'indiquez pas ce champ, le jour et le mois actuels de l'année précédente sont utilisés par défaut
valeur minimale pour le typeweb:2004-01-01
valeur minimale pour les autres types :2008-01-01
format de date :"yyyy-mm-dd"
exemple :"2019-01-15" - dateType: string | null
_to date de fin de l'intervalle de temps
champ facultatif
si vous n'indiquez pas ce champ, la date du jour est utilisée par défaut
format de date :"yyyy-mm-dd"
exemple :"2019-01-15" - keywordsType: array string[]
mots-clés
champ obligatoire
nombre maximal de mots-clés que vous pouvez indiquer : 5
évitez les symboles et caractères spéciaux (par exemple, symboles UTF, emojis) ;
si vous indiquez des caractères non latins, vous obtiendrez des données pour les pays où ils sont utilisésen savoir plus sur les règles et limites des champs
keywordetkeywordsdans les API DataForSEO dans cet article du centre d'aide - locationType: integer | null
_code code d'emplacement du moteur de recherche
champ facultatif
si vous n'utilisez pas ce champ, vous recevrez des résultats globaux
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_name
vous pouvez obtenir la liste des emplacements disponibles des moteurs de recherche avec leurlocation_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
notez que les données seront fournies pour le pays auquel appartient lelocation_codeindiqué ;
exemple :2840 - locationType: string | null
_name nom complet de l'emplacement du moteur de recherche
champ facultatif
si vous n'utilisez pas ce champ, vous recevrez des résultats globaux
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_code
vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leurlocation_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
notez que les données seront fournies pour le pays auquel appartient lelocation_nameindiqué ;
exemple :United Kingdom - 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 - timeType: string | null
_range plages de temps prédéfinies
champ facultatif
si vous indiquez les paramètresdate_fromoudate_to, ce champ sera ignoré lors de la définition d'une tâche
valeurs possibles pour tous les paramètrestype:past_4_hours,past_day,past_7_days,past_30_days,past_90_days,past_12_months,past_5_years - typeType: string | null
type d'élément
- Type: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResponseInfo200
- 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_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo
- 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
- datetimeType: string | null
date et heure de réception du résultat
au format UTC : “yyyy-mm-dd hh-mm-ss +00:00”
exemple :2019-11-15 12:57:46 +00:00 - itemsType: array (object | null)[] | null
contient la popularité du mot-clé et les données associées
- Type: object | null · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
- Type: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
- typeDiscriminateurType: string | null
type d'élément
- interestsType: array (object | null)[] | null
données de popularité sous-régionale des mots-clés pour chaque terme spécifié
- keywordType: string | null
mot-clé pertinent
les données incluses dans l'élémentvaluessont basées sur ce mot-clé - valuesType: array (object | null)[] | null
contient des données sur la popularité relative des mots-clés par pays ou région
- geoType: string | null
_id identifiant de localisation
vous pouvez utiliser ce champ pour faire correspondre les résultats obtenus aux paramètres de localisation indiqués dans la requête
consultez la liste complète des localisations disponibles avec leurgeo_idici ou en effectuant une requête distincte vershttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
exemple :US-NY - geoType: string | null
_name nom de la localisation
vous pouvez utiliser ce champ pour faire correspondre les résultats obtenus aux paramètres de localisation indiqués dans la requête
consultez la liste complète des localisations disponibles avec leurgeo_nameici ou en effectuant une requête distincte vershttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
exemple :Andorra - valueType: integer | null
taux relatif de popularité du mot-clé dans un emplacement donné
représente le taux de popularité du mot-clé propre à l'emplacement sur la période spécifiée ;
avec cettevalue, vous pouvez comprendre à quel point un mot-clé est populaire dans un emplacement par rapport à un autre ;
calcul : nous déterminons la valeur de popularité la plus élevée pour le mot-clé pertinent dans tous les emplacements, puis exprimons toutes les autres valeurs en pourcentage de cette valeur la plus élevée (100) ;
une valeur de100correspond à la popularité la plus élevée du terme
une valeur de50signifie que le terme est deux fois moins populaire
une valeur de0signifie qu'il n'y avait pas assez de données pour ce terme
- interestsType: object | null · Response36Afe1097B20_InterestsComparison
_comparison comparaison des données sur la popularité sous-régionale des mots-clés pour les paramètres spécifiés
si vous avez indiqué un seul mot-clé, la valeur seranull- absoluteType: array (object | null)[] | null
_items taux de popularité du mot-clé dans tous les emplacements
les valeurs de ce tableau représentent des pourcentages relatifs à la valeur maximale dans tous les emplacements- geoType: string | null
_id identifiant de localisation
vous pouvez utiliser ce champ pour faire correspondre les résultats obtenus aux paramètres de localisation indiqués dans la requête
consultez la liste complète des localisations disponibles avec leurgeo_idici ou en effectuant une requête distincte vershttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
exemple :US-NY - geoType: string | null
_name nom de la localisation
vous pouvez utiliser ce champ pour faire correspondre les résultats obtenus aux paramètres de localisation indiqués dans la requête
consultez la liste complète des localisations disponibles avec leurgeo_nameici ou en effectuant une requête distincte vershttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
exemple :Andorra - valuesType: array (string | null)[] | null
contient des données sur la popularité relative des mots-clés par pays ou région
- itemsType: array (object | null)[] | null
contient la popularité du mot-clé et les données associées
- geoType: string | null
_id identifiant de localisation
vous pouvez utiliser ce champ pour faire correspondre les résultats obtenus aux paramètres de localisation indiqués dans la requête
consultez la liste complète des localisations disponibles avec leurgeo_idici ou en effectuant une requête distincte vershttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
exemple :US-NY - geoType: string | null
_name nom de la localisation
vous pouvez utiliser ce champ pour faire correspondre les résultats obtenus aux paramètres de localisation indiqués dans la requête
consultez la liste complète des localisations disponibles avec leurgeo_nameici ou en effectuant une requête distincte vershttps://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
exemple :Andorra - valuesType: array (string | null)[] | null
contient des données sur la popularité relative des mots-clés par pays ou région
- keywordsType: array (string | null)[] | null
mots-clés dans un tableau POST
- positionType: integer | null
l'alignement de l'élément
peut prendre les valeurs suivantes :1,2,3,4, etc.
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - keywordsType: array (string | null)[] | null
mots-clés dans un tableau POST
- languageType: string | null
_code code de langue dans un tableau POST
s'il n'y a pas de données, la valeur est_nulln - locationType: integer | null
_code code d'emplacement dans un tableau POST
s'il n'y a pas de données, la valeur est_nulln - typeType: string | null
type d'élément
- 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/keywords_data/dataforseo_trends/subregion_interests/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keywords": [
"rugby",
"cricket"
],
"date_from": "2023-01-01",
"date_to": "2024-01-01",
"type": "web",
"location_name": "United States"
}
]'
{
"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": [
{
"keywords": [
null
],
"type": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"type": "[Max Depth Exceeded]",
"position": "[Max Depth Exceeded]",
"keywords": "[Max Depth Exceeded]",
"interests": "[Max Depth Exceeded]",
"interests_comparison": "[Max Depth Exceeded]"
}
]
}
]
}
]
}