seo/
related-keywords

Découvrez les requêtes reliées à un mot-clé de départ par les chemins de recherches associées, avec métriques de mots-clés, demande mensuelle, intention et profondeur de relation dans des enregistrements normalisés.

Related Keywords API

Graphe des recherches associées
Contrôle de la profondeur
Mesures des mots-clés
0,1 crédit par résultat
Prêt
README

Par SocQ · Mis à jour le

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ètresObligatoireDescription
queryObligatoireMot-clé ou expression de départ obligatoire et non vide. Une tâche accepte une seule requête.
location_codeFacultatifCode numérique positif du marché de recherche, facultatif.
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.
languageFacultatifNom de la langue de recherche, facultatif, en alternative à language_code. Lorsqu’il est renseigné, il prévaut sur language_code.
depthFacultatifProfondeur de relation de 0 à 4. La valeur par défaut, 1, renvoie les requêtes directement reliées.
results_limitFacultatifMaximum demandé de 1 à 1 000 mots-clés associés. Il peut y avoir moins de lignes renvoyées.
offsetFacultatifNombre 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.

  1. 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.
  2. Envoyez la charge utile en POST à /v1/seo/related-keywords et 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, 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 true

Cas 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.

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.

Explorer d’autres plateformes

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

Related Keywords API — FAQ

Related Keywords API est une interface programmatique qui trouve les requêtes reliées à un mot-clé de départ par le graphe des recherches associées d’un marché de recherche choisi. Elle renvoie le texte des mots-clés, les mesures disponibles, l’historique mensuel, l’intention, la profondeur de relation et les lignes source complètes.

depth accepte de 0 à 4 : 0 représente le mot-clé de départ envoyé, 1 couvre les relations directes, et les valeurs supérieures étendent la recherche de façon récursive. Des profondeurs plus grandes peuvent produire un vivier de candidats plus large et moins directement lié.

Non. Les liens de recherches associées peuvent renvoyer des formulations différentes ; utilisez donc Keyword Suggestions quand vous avez besoin de variantes de longue traîne contenant l’expression.

Les enregistrements normalisés peuvent inclure le texte du mot-clé, le volume de recherche, le CPC, la concurrence payante, la difficulté du mot-clé, les recherches mensuelles et l’intention. La profondeur de relation source, les chemins associés et l’objet keyword_data complet restent dans extra.

results_limit est un plafond de 1 à 1 000, tandis qu’offset est le nombre de lignes source antérieures à ignorer. offset n’est pas un numéro de page, et la source peut renvoyer moins de lignes que demandé.

Chaque mot-clé associé renvoyé coûte 0,1 crédit SocQ. Un ensemble de résultats vide n’entraîne aucun frais de résultat, et results_limit fournit l’estimation avant requête, non un nombre final garanti.