seo/
keywords-for-site

Générez des idées de mots-clés pertinentes pour le domaine d’un site web, avec volume de recherche, CPC, concurrence payante, recherches mensuelles et contexte complet dans des enregistrements normalisés.

Keywords for Site API

Pertinence par domaine
Métriques de demande des mots-clés
Enregistrements de mots-clés normalisés
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

Keywords for Site

Les enregistrements de Keywords for Site relient la thématique d’un site web à des termes de recherche pertinents, au volume de recherche, au CPC, à la concurrence payante, à la demande mensuelle et au contexte de catégorie. Ces liens entre mots-clés et métriques servent à découvrir des thèmes, à étudier la concurrence, à constituer des listes de candidats et à comparer plusieurs domaines.

Fonctionnalités de la Keywords for Site API

  • Découverte par pertinence à partir d’un domainePartez du domaine d’un site web pour récupérer les idées de mots-clés associées à sa thématique, plutôt que d’une expression de départ.
  • Métriques de demande et de recherche payanteÉvalue chaque mot-clé renvoyé grâce au volume de recherche normalisé, au CPC, à la concurrence payante, au niveau de concurrence et aux observations de recherche mensuelles.
  • Contexte complet du mot-cléConsultez extra pour la ligne renvoyée en entier : catégories facultatives, difficulté, intention, champs de tendance et autres attributs non promus y restent accessibles.

Paramètres de la Keywords for Site API

ParamètresObligatoireDescription
targetObligatoireDomaine du site web obligatoire, utilisé comme source de la thématique. Le Playground utilise microsoft.com par défaut.
location_codeFacultatifCode de localisation du marché de recherche, positif et facultatif. Le Playground envoie 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 facultatif, de 2 à 10 caractères. Le Playground envoie 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_limitFacultatifPlafond de résultats source demandé, de 1 à 1 000. Le Playground envoie 5 pour correspondre à l’exemple de la documentation ; le backend utilise 100 s’il est omis.

Comment utiliser la Keywords for Site API

Envoyez un domaine avec les réglages de marché, de langue et de limite de résultats, puis lisez les enregistrements de mots-clés normalisés dans la tâche terminée.

  1. Choisissez un domaine cible, un location_code positif, un language_code et un results_limit de 1 à 1 000.
  2. Envoyez la charge utile en POST à /v1/seo/keywords-for-site 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 suivez next_cursor tant que has_more reste à true.
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Cas d’usage de la Keywords for Site API

  • Découverte des thématiques d’un site : Appuyez-vous sur les mots-clés et catégories renvoyés pour repérer les thèmes de recherche associés à un site web connu.
  • Étude des mots-clés d’un concurrent : Envoyez le domaine d’un concurrent et combinez les termes pertinents avec le volume de recherche, le CPC et la concurrence payante pour constituer un ensemble d’étude.
  • Comparaison thématique entre domaines : Lancez les sites cibles séparément et comparez les ensembles de mots-clés, les catégories et les métriques de demande renvoyés.

Conseils d’expert pour la Keywords for Site API

  • Retirez http:// et https:// de target avant d’envoyer le domaine, afin d’éviter un format de cible invalide.
  • Définissez explicitement le marché et la langue quand vous comparez des exécutions, au lieu de dépendre du comportement du fournisseur pour les champs omis.
  • Choisissez pour results_limit le plus grand ensemble de résultats utile en une fois, car cet endpoint n’a pas d’offset pour demander une fenêtre de résultats plus tardive.
  • Traitez les métriques manquantes comme indisponibles et non comme nulles, et consultez extra quand un attribut nécessaire n’est pas présent dans les champs normalisés.
  • Utilisez plutôt Ranked Keywords quand la tâche exige des positions observées ou des URL classées, et non des idées de mots-clés fondées sur la pertinence.

En complément de la Keywords for Site 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.
  • Ranked Keywords API — Trouvez les mots-clés sur lesquels se classe un domaine, un sous-domaine ou une page, avec URL correspondantes, positions, mesures de recherche, intention et éléments sources complets.
  • Relevant Pages API — Recensez les pages indexées d’un domaine avec la répartition des classements organiques et payants, le trafic modélisé et le contexte de coût estimé.

Explorer d’autres plateformes

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

Keywords for Site API — FAQ

Keywords for Site API est une interface programmatique qui génère des idées de mots-clés à partir du domaine d’un site web. Elle renvoie des mots-clés normalisés avec volume de recherche, CPC, concurrence payante, recherches mensuelles et contexte complet ; la pertinence n’établit pas un classement.

Envoyez un seul domaine, par exemple example.com, sans http:// ni https://. L’endpoint accepte un site web cible par tâche.

Non. Les termes renvoyés sont des candidats fondés sur la pertinence, pas la preuve que le site se classe sur eux. Utilisez Ranked Keywords quand les positions et les URL correspondantes sont nécessaires.

Non. results_limit accepte de 1 à 1 000 et fixe le nombre maximal de lignes pour une tâche, mais l’entrée publique n’a pas d’offset pour demander une fenêtre de résultats plus tardive.

Chaque mot-clé renvoyé coûte 0,1 crédit SocQ. Une tâche sans ligne renvoyée n’entraîne aucun frais de résultat.