Keyword Suggestions
Les suggestions de mots-clés sont des termes de recherche de longue traîne qui contiennent un mot ou une expression de départ, avec des ajouts avant, après ou à l’intérieur ; leurs enregistrements peuvent comporter des signaux de demande, de coût, de concurrence, d’historique mensuel et d’intention. Ces termes correspondants et leurs mesures servent à étendre les requêtes, à préparer des briefs de contenu, à analyser la recherche payante et à comparer de façon contrôlée des variantes de formulation.
Fonctionnalités de la Keyword Suggestions API
- Extension en texte intégral à partir d’une requête de départRenvoie les termes de recherche qui gardent les mots de départ envoyés, en admettant des ajouts avant, après ou à l’intérieur de l’expression ainsi qu’un ordre des mots différent.
- Objets de mesure des mots-clésConserve dans les données source de chaque enregistrement le volume de recherche, le CPC, la concurrence payante, l’historique mensuel et les détails de difficulté disponibles.
- Contexte d’intention de rechercheExpose l’intention principale et secondaire disponible pour chaque mot-clé correspondant, sans la présenter comme une recommandation de classement.
- Fenêtres de résultats maîtriséesAccepte un plafond de résultats de 1 à 1 000 et un décalage de lignes à partir de zéro pour récupérer une fenêtre plus tardive de la source.
Paramètres de la Keyword Suggestions API
| Paramètres | Obligatoire | Description |
|---|---|---|
query | Obligatoire | Mot-clé ou expression de départ obligatoire et non vide. Une tâche accepte une seule requête. |
location_code | Facultatif | Code numérique positif du marché de recherche. Le Playground utilise 2840 par défaut. |
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. 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 | Maximum demandé de 1 à 1 000 suggestions. Il peut y avoir moins de lignes renvoyées. |
offset | Facultatif | Nombre de lignes source à ignorer, en comptant à partir de zéro, avant de collecter la fenêtre de résultats demandée. |
Comment utiliser la Keyword Suggestions API
Envoyez une requête de départ avec les réglages de marché et une fenêtre de résultats bornée, puis lisez chaque suggestion dans la tâche asynchrone terminée.
- Choisissez une requête query non vide, un location_code, un language_code, un results_limit de 1 à 1 000 et un offset supérieur ou égal à 0.
- Envoyez la charge utile en POST à /v1/seo/keyword-suggestions et 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, puis demandez le next_cursor renvoyé tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/seo/keyword-suggestions" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","location_code":2840,"language_code":"en","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCas d’usage de la Keyword Suggestions API
- Extension de requêtes de longue traîne : Partez d’une expression de départ et du texte des mots-clés renvoyés pour collecter des variantes de requête plus longues qui conservent les mots d’origine.
- Recherche de candidats pour un brief de contenu : Combinez les termes correspondants avec le volume, l’historique mensuel, la difficulté et l’intention disponibles pour constituer un ensemble de mots-clés à relire.
- Comparaison de mots-clés pour la recherche payante : Comparez le CPC et la concurrence payante disponibles entre variantes de formulation avant de confier les candidats à un workflow de planification.
Conseils d’expert pour la Keyword Suggestions API
- Utilisez une expression de départ précise quand vous voulez des variantes de longue traîne très proches ; choisissez un endpoint de mots-clés sémantiques si les termes n’ont pas besoin de contenir les mots de départ.
- Voyez dans offset un nombre de lignes et non un numéro de page, et augmentez-le de la taille de la fenêtre source que vous voulez ignorer.
- Notez ensemble query, location_code, language_code, results_limit et offset, car l’ordre de la source peut changer d’une requête à l’autre, même identiques par ailleurs.
- Lisez d’abord keyword et search_intent dans les champs normalisés, puis consultez extra.keyword_info et extra.keyword_properties pour les objets de mesure directs qui ne sont pas promus.
- Dédoublonnez les fenêtres répétées par mot-clé, marché et langue, et admettez que chaque métrique facultative ou objet imbriqué puisse être absent.
API associées
En complément de la Keyword Suggestions 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.
- 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.
- Ranked Keywords API
- Relevant Pages API
- Search Intent 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