seo/
keyword-overview

Enrichissez jusqu’à 1 000 mots-clés connus sur un marché avec le volume de recherche, le CPC, la concurrence payante, la difficulté, les tendances mensuelles et l’intention disponibles, dans des enregistrements normalisés.

Keyword Overview API

Métriques de mots-clés combinées
Jusqu’à 1 000 mots-clés
Signaux de demande et de concurrence
0,15 crédit par mot-clé
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 Overview

Les enregistrements de Keyword Overview réunissent la demande de recherche, la concurrence payante, la difficulté organique, des observations mensuelles et l’intention classée de termes de recherche connus. Ces signaux complémentaires servent à enrichir des listes de termes, à comparer des opportunités, à segmenter la recherche et à analyser la demande dans le temps.

Fonctionnalités de la Keyword Overview API

  • Lot de mots-clés connus en entréeÉvalue de 1 à 1 000 mots-clés préparés dans un même contexte de marché et de langue de recherche.
  • Champs de demande et de recherche payanteConserve le volume de recherche, le CPC, la concurrence, le niveau de concurrence, l’indice de concurrence et les observations mensuelles disponibles pour comparer la demande et le marché payant.
  • Difficulté organique et intentionAjoute la difficulté du mot-clé et l’intention de recherche lorsqu’elles sont disponibles, à côté des champs de demande, pour que ces signaux distincts restent rattachés au même terme.
  • Ligne d’aperçu complèteGarde dans extra keyword_info, keyword_properties, les métadonnées des résultats de recherche et les autres objets renvoyés lorsqu’ils sont présents.

Paramètres de la Keyword Overview 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. Le Playground utilise 2840 par défaut, pour les États-Unis.
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 de 2 à 10 caractères, appliqué au lot. Le Playground utilise en par défaut.
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 Overview API

Envoyez une liste bornée de mots-clés connus avec des réglages de marché par codes, puis lisez les champs normalisés et les objets d’aperçu complets 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 avec location_code et language_code en POST à /v1/seo/keyword-overview, 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 consultez extra.keyword_info ou extra.keyword_properties pour les champs source non promus ; suivez next_cursor tant que has_more vaut true.
curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
  -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 Overview API

  • Enrichissement d’une liste de mots-clés : Rattachez les champs keyword_info et keyword_properties renvoyés à une liste de termes préparée pour obtenir un dossier de recherche commun.
  • Comparaison entre demande et concurrence : Comparez volume de recherche, CPC, concurrence payante et difficulté du mot-clé, sans considérer les signaux payants et organiques comme interchangeables.
  • Segmentation par intention et par tendance : Associez l’intention de recherche aux observations mensuelles pour classer les termes connus selon leur finalité probable et leur profil de demande.

Conseils d’expert pour la Keyword Overview API

  • Dédoublonnez les mots-clés avant l’envoi, car les frais sont calculés d’après le nombre d’entrées.
  • Laissez location_code et language_code fixes quand vous comparez des termes, pour que le contexte de recherche choisi reste cohérent.
  • Omettez results_limit, car le tableau keywords pilote ce lot et l’opération d’aperçu n’a pas de contrôle de limite de résultats documenté.
  • Lisez extra.keyword_info et extra.keyword_properties pour obtenir l’aperçu complet, car toutes les valeurs de la source ne sont pas promues en champ normalisé de premier niveau.
  • Traitez les champs manquants comme des données indisponibles et non comme un zéro numérique, et rapprochez les enregistrements renvoyés par mot-clé plutôt que par position dans le tableau.
  • Interprétez le CPC et la concurrence comme des signaux de recherche payante, alors que keyword_difficulty représente la concurrence organique estimée.

En complément de la Keyword Overview 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 Search Volume API — Mesurez des mots-clés connus avec le volume de recherche, le CPC, la concurrence payante et l’historique mensuel des recherches 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.
  • Related Keywords API — Suivez les chemins de recherches associées à partir d’une requête de départ avec contrôle de la profondeur, mesures de mots-clés disponibles, intention de recherche et lignes sources complètes.
  • Search Intent API — Classez l’intention de recherche principale et secondaire d’un lot de mots-clés soumis, en conservant les probabilités sources et les enregistrements complets.

Explorer d’autres plateformes

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

Keyword Overview API — FAQ

Keyword Overview API est une interface programmatique qui enrichit de 1 à 1 000 mots-clés connus sur un marché de recherche. Elle renvoie, pour chaque mot-clé disposant de données, la demande, la concurrence payante, la difficulté organique, les recherches mensuelles, l’intention et les champs de la ligne source complète.

Le tableau keywords obligatoire définit le lot, avec de 1 à 1 000 chaînes non vides de 80 caractères au plus chacune. location_code et language_code choisissent le contexte de recherche utilisé par le Playground.

Lisez d’abord metrics, monthly_searches et search_intent normalisés, puis consultez extra.keyword_info et extra.keyword_properties pour les champs source qui n’ont pas été promus. Les clés à l’intérieur de extra restent facultatives et souples.

Non. Le CPC et la concurrence décrivent des signaux de recherche payante, tandis que keyword_difficulty estime la concurrence pour le classement organique ; utilisez chaque champ pour sa propre comparaison.

Chaque mot-clé envoyé coûte 0,15 crédit SocQ, y compris les entrées qui ne produisent aucune ligne renvoyée. La valeur par défaut du Playground, avec deux mots-clés, est donc estimée à 0,3 crédit.