seo/
ranked-keywords

Trouvez les mots-clés pour lesquels un domaine, un sous-domaine ou une page se classe sur un marché de recherche, avec URL, positions, métriques de recherche, intention et contexte de trafic estimé.

Ranked Keywords API

Cible domaine ou page
Correspondance avec l’URL classée
Contexte de position
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

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ètresObligatoireDescription
targetObligatoireCible 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_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 lignes de mots-clés classé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 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.

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

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

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

Explorer d’autres plateformes

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

Ranked Keywords API — FAQ

Ranked Keywords API est une interface programmatique qui trouve les termes de recherche associés à un domaine, un sous-domaine ou une page sur un marché et dans une langue choisis. Elle renvoie les URL correspondantes, les positions, les mesures des mots-clés, l’historique mensuel, l’intention et les éléments source complets.

Utilisez un domaine seul sans https:// ni www., un sous-domaine sans le protocole, ou une URL complète pour une page. Indiquer un chemin de page sans protocole peut élargir le périmètre à tout le domaine.

Non. Les positions décrivent l’index de recherche et le marché choisis, et non un résultat en direct identique pour chaque utilisateur ; utilisez donc collected_at pour comparer des instantanés répétés.

rank.page est le numéro de la page de résultats de recherche, offset ignore des lignes de mots-clés de la source, et next_cursor parcourt les résultats déjà stockés pour la tâche SocQ. Ces valeurs ne sont pas interchangeables.

Non. etv est une valeur modélisée conservée dans extra.ranked_serp_element, et non des statistiques privées de trafic ou de conversion de la cible.

Chaque mot-clé classé 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.