seo/
keyword-suggestions

Développez une requête de départ en termes de longue traîne sur un marché de recherche choisi, avec les mots-clés correspondants, les métriques de demande disponibles, l’historique mensuel et les lignes source complètes.

Keyword Suggestions API

Correspondance avec l’expression de départ
Termes de longue traîne
Fenêtres par décalage
0,1 crédit par résultat
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 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è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. Le Playground utilise 2840 par défaut.
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. 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_limitFacultatifMaximum demandé de 1 à 1 000 suggestions. 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 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.

  1. 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.
  2. Envoyez la charge utile en POST à /v1/seo/keyword-suggestions 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/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 true

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

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.

Explorer d’autres plateformes

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

Keyword Suggestions API — FAQ

Keyword Suggestions API est une interface programmatique qui trouve des termes de recherche de longue traîne à partir d’une requête de départ, d’un code de marché et d’un code de langue. Elle renvoie les mots-clés correspondants, les détails de demande et de concurrence disponibles, l’historique mensuel, le contexte d’intention et les lignes source complètes.

Les suggestions contiennent les mots de départ envoyés, avec des ajouts avant, après ou à l’intérieur, mais leur ordre peut différer. Utilisez l’endpoint pour une extension en texte intégral plutôt que pour de larges alternatives sémantiques.

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 l’ordre de la source peut évoluer dans le temps.

Les champs stables keyword et d’intention disponibles sont normalisés, tandis que les mesures de recherche directes et les propriétés du mot-clé peuvent rester dans extra.keyword_info et extra.keyword_properties. Les clients doivent traiter chaque valeur facultative comme pouvant être nulle.

Chaque suggestion renvoyée 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.