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ètres | Obligatoire | Description |
|---|---|---|
keywords | Obligatoire | Liste obligatoire de 1 à 1 000 mots-clés connus et non vides, de 80 caractères au maximum par élément. |
location_code | Facultatif | Code numérique positif du marché de recherche. Le Playground utilise 2840 par défaut, pour les États-Unis. |
location_name | Facultatif | Nom du marché de recherche, facultatif, en alternative à location_code. Lorsqu’il est renseigné, il prévaut sur location_code. |
language_code | Facultatif | Code de langue de recherche de 2 à 10 caractères, appliqué au lot. Le Playground utilise en par défaut. |
language | Facultatif | Nom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code. |
results_limit | Facultatif | Limite 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.
- Préparez de 1 à 1 000 mots-clés connus non vides, de 80 caractères au plus chacun.
- Envoyez keywords avec location_code et language_code en POST à /v1/seo/keyword-overview, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou renvoie un échec.
- 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 trueCas 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.
API associées
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.
- Keyword Suggestions API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API