Ranked Keywords
Les mots-clés classés sont des requêtes de recherche reliées à un domaine, un sous-domaine ou une page par l’URL d’un résultat correspondant, avec les positions dans le groupe, absolue et par page de résultats, ainsi que les signaux disponibles de demande, de difficulté, d’intention et de trafic. Ces relations entre requêtes et pages servent à dresser des inventaires de visibilité, à cartographier les pages de destination, à examiner les opportunités et à comparer des instantanés de cibles.
Fonctionnalités de la Ranked Keywords API
- Périmètre domaine, sous-domaine ou pageRésout une cible web correctement formatée, avec l’étendue voulue : un domaine entier, un sous-domaine ou l’URL complète d’une page.
- Relations entre mots-clés et URLAssocie chaque mot-clé renvoyé à l’URL de destination correspondante exposée par son élément de résultat de recherche classé.
- Positions et mesures des mots-clésRenvoie les positions disponibles dans le groupe, absolues et par page de résultats, avec le volume de recherche, le CPC, la concurrence, la difficulté, l’historique mensuel et l’intention.
- Élément correspondant completConserve keyword_data et ranked_serp_element dans extra, pour que le type de résultat, le trafic modélisé et les détails source non promus restent accessibles.
Paramètres de la Ranked Keywords API
| Paramètres | Obligatoire | Description |
|---|---|---|
target | Obligatoire | Cible obligatoire : domaine, sous-domaine ou page. Omettez https:// et www. pour un domaine, omettez le protocole pour un sous-domaine, ou utilisez une URL complète pour une page. |
location_code | Facultatif | Code numérique positif du marché de recherche. Le Playground utilise 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 de 2 à 10 caractères. Le Playground utilise 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 | Maximum demandé de 1 à 1 000 lignes de mots-clés classé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 Ranked Keywords API
Envoyez une cible correctement délimitée avec les réglages de marché et une fenêtre de résultats bornée, puis lisez chaque mot-clé classé dans la tâche asynchrone terminée.
- Choisissez une cible target, un location_code, un language_code, un results_limit de 1 à 1 000 et un offset supérieur ou égal à 0.
- Envoyez la charge utile en POST à /v1/seo/ranked-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/ranked-keywords" \
-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 Ranked Keywords API
- Inventaire de la visibilité organique : Servez-vous du texte des mots-clés renvoyés et des URL correspondantes pour répertorier où apparaît un domaine ou un sous-domaine sur le marché de recherche choisi.
- Carte des classements par page de destination : Combinez chaque mot-clé, son URL de destination et son objet rank pour identifier la page associée à chaque position renvoyée.
- Examen des opportunités de mots-clés : Comparez la position avec le volume, le CPC, la concurrence, la difficulté et l’intention disponibles pour constituer une file d’examen.
- Comparaison d’instantanés de visibilité : Stockez les entrées de cible identiques, collected_at, les mots-clés, les URL et les rangs issus de tâches répétées pour comparer des instantanés collectés séparément.
Conseils d’expert pour la Ranked Keywords API
- Retirez https:// et www. d’une cible de type domaine, et le protocole d’une cible de type sous-domaine, pour que le périmètre voulu soit bien interprété.
- Utilisez l’URL complète d’une page quand vous voulez des résultats au niveau de la page : un chemin de page sans protocole peut être interprété comme une cible portant sur tout le domaine.
- Augmentez offset du nombre de lignes source que vous voulez ignorer, et gardez la cible, le marché, la langue et la limite fixes pour récupérer des fenêtres consécutives.
- Voyez dans rank.page le numéro de la page de résultats de recherche ; utilisez offset pour les fenêtres de la source et next_cursor à part pour les pages de résultats stockées par SocQ.
- Lisez d’abord les positions et les métriques de mots-clés normalisées, puis consultez extra.ranked_serp_element pour etv modélisé et les autres champs source non promus.
- Construisez les comparaisons historiques à partir de tâches répétées, et dédoublonnez les fenêtres par mot-clé, URL correspondante, marché et langue, car l’ordre de la source peut changer.
API associées
En complément de la Ranked 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.
- 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.
- 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