Related Keywords
Les mots-clés associés sont des requêtes reliées entre elles par le graphe des recherches associées, avec des signaux de profondeur, de demande, de CPC, de concurrence, de difficulté et d’intention. Ces relations et ces mesures servent à découvrir des sujets voisins, à étendre une carte thématique et à comparer des candidats.
Fonctionnalités de la Related Keywords API
- Exploration du graphe des recherches associéesSuit les relations directes ou récursives entre requêtes à partir d’un mot-clé de départ, avec une profondeur de 0 à 4, sans exiger que les termes contiennent l’expression.
- Objets de mesure des mots-clésRenvoie le volume de recherche, le CPC, la concurrence payante, l’historique mensuel, la difficulté et l’intention disponibles pour chaque requête reliée.
- Contexte de relation conservéGarde dans extra la profondeur source, les chemins entre mots-clés associés, l’objet keyword_data complet et les autres champs variables, pour interpréter le graphe en détail.
Paramètres de la Related Keywords 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, facultatif. |
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 facultatif, de 2 à 10 caractères. |
language | Facultatif | Nom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code. |
depth | Facultatif | Profondeur de relation de 0 à 4. La valeur par défaut, 1, renvoie les requêtes directement reliées. |
results_limit | Facultatif | Maximum demandé de 1 à 1 000 mots-clés associés. 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 Related Keywords API
Envoyez une requête de départ avec une profondeur de relation, les réglages de marché et une fenêtre de résultats bornée, puis lisez les enregistrements associés dans la tâche asynchrone terminée.
- Choisissez une requête query non vide, un location_code, un language_code, une depth de 0 à 4, un results_limit de 1 à 1 000 et un offset supérieur ou égal à 0.
- Envoyez la charge utile en POST à /v1/seo/related-keywords 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/related-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","depth":1,"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 Related Keywords API
- Découverte de sujets voisins : Servez-vous du texte des requêtes renvoyées et du contexte de relation pour trouver des sujets reliés qui n’ont pas besoin de contenir l’expression de départ.
- Extension d’une carte thématique : Comparez la profondeur et les chemins entre mots-clés associés pour étendre un mot-clé de départ, de ses voisins directs vers un graphe de requêtes plus large.
- Évaluation de mots-clés candidats : Combinez les termes associés avec la demande, le coût, la concurrence, la difficulté, l’historique mensuel et l’intention disponibles pour préparer un ensemble de candidats à relire.
Conseils d’expert pour la Related Keywords API
- Commencez avec une profondeur de 1 pour les relations directes, et ne l’augmentez que si un graphe plus large vaut le vivier de candidats plus grand et parfois moins direct.
- Utilisez plutôt Keyword Suggestions quand chaque terme renvoyé doit conserver les mots de départ, car les requêtes associées peuvent employer une autre formulation.
- Gardez query, location_code, language_code et depth fixes quand vous comparez des fenêtres de résultats, pour que le contexte de relation et de marché reste comparable.
- Voyez dans offset un nombre de lignes et non un numéro de page, et augmentez-le du nombre de lignes source que vous voulez ignorer.
- Lisez d’abord keyword, metrics, monthly_searches et search_intent dans les champs normalisés, puis consultez extra pour la profondeur source et les chemins de relation.
- Ne déduisez pas une intention identique de la simple proximité dans le graphe, et admettez que les mesures facultatives et les champs variables de extra puissent être absents.
API associées
En complément de la Related Keywords 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.
- 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.
- 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.
- Keywords for Site 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