seo/
keyword-search-volume

Mesurez jusqu’à 1 000 mots-clés connus avec le volume de recherche, le CPC, la concurrence payante et l’historique mensuel disponibles, dans des enregistrements normalisés pour un marché ou à l’échelle mondiale.

Keyword Search Volume API

Mesures de mots-clés connus
Jusqu’à 1 000 mots-clés
Historique mensuel de la demande
24 crédits par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Keyword Search Volume

Les enregistrements de volume de recherche associent des termes connus à une demande estimée, au CPC, à la concurrence payante et à des observations mensuelles, pour un contexte de recherche choisi ou mondial. Ces mesures servent à comparer la demande, à examiner la saisonnalité, à mener des études sur le marché payant et à enrichir des listes de termes.

Fonctionnalités de la Keyword Search Volume API

  • Mesure d’un lot de mots-clés connusMesure de 1 à 1 000 mots-clés préparés en une seule requête, chaque entrée étant limitée à 80 caractères.
  • Champs de demande de rechercheRenvoie les valeurs search_volume et les observations monthly_searches disponibles pour chaque mot-clé qui dispose de données de mesure.
  • Contexte du marché payantGarde le CPC, la concurrence, le niveau de concurrence, l’indice de concurrence et les champs d’enchère facultatifs rattachés au terme mesuré, lorsqu’ils sont disponibles.
  • Enregistrements normalisés avec contexte sourcePlace les champs de demande stables dans metrics et conserve dans extra la ligne renvoyée en entier, avec les métadonnées facultatives de marché et d’enchère.

Paramètres de la Keyword Search Volume API

ParamètresObligatoireDescription
keywordsObligatoireListe obligatoire de 1 à 1 000 mots-clés connus et non vides, de 80 caractères au maximum par élément.
location_codeFacultatifCode numérique positif du marché de recherche, facultatif. Le Playground envoie explicitement 2840 pour les États-Unis ; videz ce champ en même temps que language_code pour utiliser la portée mondiale du backend.
location_nameFacultatifNom du marché de recherche, facultatif, en alternative à location_code. Lorsqu’il est renseigné, il prévaut sur location_code.
language_codeFacultatifCode de langue de recherche facultatif, de 2 à 10 caractères. Le Playground envoie explicitement en ; videz ce champ en même temps que location_code pour utiliser la portée mondiale du backend.
languageFacultatifNom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code.
results_limitFacultatifLimite de résultats facultative, de 1 à 2 000.

Comment utiliser la Keyword Search Volume API

Envoyez une liste bornée de mots-clés connus avec des réglages facultatifs de marché et de langue, puis lisez les champs de demande normalisés dans les enregistrements de résultats asynchrones.

  1. Préparez de 1 à 1 000 mots-clés connus non vides, de 80 caractères au plus chacun.
  2. Envoyez keywords en POST à /v1/seo/keyword-search-volume ; ajoutez location_code et language_code pour une requête reproductible propre à un marché, puis conservez le task_id renvoyé.
  3. Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
  4. Lisez data.results.items et suivez next_cursor tant que has_more vaut true ; consultez extra pour les champs source non promus.
curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["keyword research","seo tools"],"location_code":2840,"language_code":"en"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Keyword Search Volume API

  • Comparaison de la demande sur une liste préparée : Rattachez les valeurs search_volume à une liste de termes connue et comparez la demande estimée dans un contexte de recherche constant.
  • Étude de la saisonnalité mensuelle : Appuyez-vous sur les observations year, month et search_volume pour examiner l’évolution de la demande mesurée dans le temps.
  • Étude du paysage de la recherche payante : Comparez le CPC, la concurrence, l’indice de concurrence et le contexte d’enchère facultatif entre les mots-clés mesurés.

Conseils d’expert pour la Keyword Search Volume API

  • Regroupez les termes préparés en un lot borné lorsque c’est pertinent, car les 24 crédits fixes s’appliquent à la requête et non à chaque ligne renvoyée.
  • Renseignez location_code et language_code explicitement et sans les modifier quand vous comparez des lots ; omettez les deux uniquement si vous visez la portée mondiale.
  • N’envoyez pas results_limit, car le tableau keywords pilote le lot de cette opération et celle-ci n’a pas de contrôle de limite documenté.
  • Rapprochez les lignes renvoyées par mot-clé et traitez les enregistrements manquants ou les champs nuls comme des données indisponibles, non comme une demande nulle avérée.
  • Interprétez le CPC et la concurrence comme des signaux de recherche payante, non comme une difficulté de classement organique, et tenez compte des variantes proches qui peuvent partager un volume agrégé.

En complément de la Keyword Search Volume API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques SEO.

  • Google Organic SERP API — Récupérez une page de résultats Google en direct par requête et marché, avec destinations, positions, types d’éléments et détail complet des résultats normalisés.
  • Keyword Difficulty API — Comparez la difficulté de classement organique d’un lot de mots-clés soumis et obtenez chaque mot-clé disponible avec son score normalisé.
  • Keyword Overview API — Enrichissez un lot de mots-clés soumis avec la demande, la concurrence payante, la difficulté, les recherches mensuelles et l’intention de recherche disponibles.
  • Keywords for Site API — Générez des mots-clés pertinents pour un site web avec les mesures de demande disponibles, l’historique mensuel, le contexte de marché et les lignes sources complètes.
  • Keyword Suggestions API — Développez une requête de départ en termes de longue traîne correspondants, avec mesures de demande disponibles, historique mensuel, intention de recherche et lignes sources complètes.
  • Ranked Keywords API — Trouvez les mots-clés sur lesquels se classe un domaine, un sous-domaine ou une page, avec URL correspondantes, positions, mesures de recherche, intention et éléments sources complets.

Explorer d’autres plateformes

Combinez les données SEO avec les données publiques d’autres plateformes sociales prises en charge.

Keyword Search Volume API — FAQ

Keyword Search Volume API est une interface programmatique qui mesure de 1 à 1 000 mots-clés connus sur un marché choisi ou à l’échelle mondiale. Elle renvoie, pour chaque mot-clé disposant de données, le volume de recherche, le CPC, la concurrence payante, l’historique mensuel et les champs de la ligne source complète.

Le tableau keywords obligatoire accepte de 1 à 1 000 chaînes non vides de 80 caractères au plus chacune. location_code et language_code sont facultatifs ; le backend applique la portée mondiale lorsque le marché et la langue sont omis.

Une ligne absente ou un champ nul signifie que les données de mesure étaient indisponibles, pas forcément que la demande est nulle. Des variantes proches d’un mot-clé peuvent aussi partager une valeur de volume de recherche agrégée.

Non. Le CPC, la concurrence, competition_level, competition_index et les champs d’enchère décrivent le contexte de la recherche payante ; cet endpoint ne calcule pas la difficulté organique du mot-clé.

Chaque requête envoyée coûte 24 crédits SocQ fixes, quel que soit le nombre de mots-clés ou de lignes renvoyées dans le lot accepté.