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ètres | Obligatoire | Description |
|---|---|---|
target | Obligatoire | Domaine du site web obligatoire, utilisé comme source de la thématique. Le Playground utilise microsoft.com par défaut. |
location_code | Facultatif | Code de localisation du marché de recherche, positif et facultatif. Le Playground envoie 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 facultatif, de 2 à 10 caractères. Le Playground envoie 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 | Plafond 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.
- Choisissez un domaine cible, un location_code positif, un language_code et un results_limit de 1 à 1 000.
- Envoyez la charge utile en POST à /v1/seo/keywords-for-site 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 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 trueCas 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.
API associées
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é.
- Keyword Suggestions API
- Related Keywords 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