Configurer les tâches ‘Bulk Clickstream Search Volume’ en temps réel
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches ‘Bulk Clickstream Search Volume’ en temps réel
Volume de recherche clickstream pour de nombreux keywords en un seul appel, sans la dimension de langue. 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. La variante par mot-clé avec langue est post_dataforseo_keywords_clickstream_search_volume_live. Comme le prix est par appel et non par mot-clé, c'est celle à utiliser pour une liste.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.09.
- 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)[]
- keywordsType: array string[]
mots-clés cibles
champ obligatoire
encodage UTF-8
nombre maximal de mots-clés que vous pouvez indiquer dans ce tableau : 1000 ;
chaque mot-clé doit comporter au moins 3 caractères ;
les mots-clés sont convertis en minuscules ;
Remarque : certains symboles et caractères (par exemple, les symboles UTF, les emojis) ne sont pas autorisés
pour savoir quels symboles et caractères peuvent être utilisés, consultez cet articleen savoir plus sur les règles et limites des champs
keywordetkeywordsdans les API DataForSEO dans cet article du centre d'aide - locationType: integer
_code code d'emplacement
champ obligatoire si vous ne spécifiez paslocation_name
Remarque : il est obligatoire d'indiquerlocation_nameoulocation_code
vous pouvez recevoir la liste des emplacements disponibles avec leurlocation_codeen effectuant une requête distincte vers lehttps://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
exemple :2840 - locationType: string
_name nom complet de l'emplacement
champ obligatoire si vous ne spécifiez paslocation_code
Remarque : il est obligatoire d'indiquerlocation_nameoulocation_code
vous pouvez recevoir la liste des emplacements disponibles avec leurlocation_nameen effectuant une requête distincte vers lehttps://api.dataforseo.com/v3/keywords_data/clickstream_data/locations_and_languages
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
- Type: object | null · Response36Afe1097B20_KeywordsDataClickstreamDataBulkSearchVolumeLiveResponseInfo200
- 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_KeywordsDataClickstreamDataBulkSearchVolumeLiveTaskInfo
- 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
- keywordType: string | null
mot-clé fourni dans le tableau POST
- 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 Format: int64
_volume taux actuel de volume de recherche d'un mot-clé
- itemsType: integer | null Format: int64
_count le nombre de résultats renvoyés dans le tableau
items - locationType: integer | null
_code code de localisation dans un tableau POST
- 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/clickstream_data/bulk_search_volume/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"location_code": 2840,
"tag": "test-tag",
"keywords": [
"you tube",
"youtube",
"youtub"
]
}
]'
{
"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": [
{
"location_code": null,
"items_count": null,
"items": [
{
"keyword": null,
"search_volume": null,
"monthly_searches": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}