L'API Ranktracker est désormais disponible — Accès inclus dans toutes les formules

Introduction

L'API Ranktracker est officiellement disponible.

Tous les forfaits Ranktracker incluent désormais l'accès à l'API, offrant ainsi aux clients un moyen direct de connecter Ranktracker à leurs propres tableaux de bord, plateformes de reporting, systèmes internes et workflows SEO.

Vous n’avez plus besoin d’un abonnement API distinct ni d’un compte réservé aux entreprises pour commencer à développer vos applications. Que vous utilisiez la formule Launch, Growth, Scale ou Authority, vous pouvez créer une clé API et exploiter par programmation les données disponibles dans votre compte Ranktracker.

L’API s’appuie sur les mêmes quotas de mots-clés, de lignes de données et de suivi inclus dans votre formule. Les formules supérieures offrent des quotas plus importants, mais l’accès à l’API est ouvert à tous.

Consultez la documentation complète destinée aux développeurs sur developers.ranktracker.com.

Pourquoi avons-nous développé l’API Ranktracker ?

Les équipes SEO ont de plus en plus besoin d’accéder à leurs données de référencement en dehors d’une plateforme unique.

Les agences souhaitent intégrer les données de classement dans les portails clients. Les équipes internes souhaitent associer les classements aux analyses, aux prospects et au chiffre d'affaires. Les développeurs souhaitent automatiser les tâches répétitives de gestion de projet. Les grandes entreprises souhaitent stocker leurs données SEO dans leurs propres entrepôts de données et systèmes de veille économique.

Les exportations manuelles peuvent fonctionner ponctuellement, mais elles deviennent inefficaces lorsque les rapports doivent être actualisés quotidiennement pour des centaines de domaines ou des milliers de mots-clés.

L’API Ranktracker résout ce problème en permettant à vos systèmes de communiquer directement avec Ranktracker.

Vous pouvez désormais récupérer des données de classement, gérer les projets suivis, organiser les mots-clés et créer des workflows de reporting sans avoir à répéter manuellement les mêmes actions dans le tableau de bord.

L'accès à l'API est inclus dans toutes les formules Ranktracker

L'accès à l'API n'est pas réservé à notre formule la plus complète.

Il est inclus dans :

• Lancement
• Croissance
• Scale
• Autorité

Votre activité API s'inscrit dans les limites des quotas de mots-clés, de lignes de données, de concurrents et autres associés à votre abonnement.

Par exemple, si vous ajoutez des mots-clés via l’API, ceux-ci sont décomptés des mêmes limites de compte que les mots-clés ajoutés via l’interface Ranktracker. Vous pouvez vérifier votre utilisation actuelle et votre capacité restante par programmation avant de lancer une importation volumineuse.

Cela permet à chaque client de tester l’automatisation, quelle que soit la taille de son entreprise ou ses ressources techniques.

Les petites entreprises peuvent connecter Ranktracker à un simple tableau de bord interne. Les agences peuvent automatiser l’intégration des clients et la création de rapports. Les équipes plus importantes peuvent mettre en place des pipelines de données complets autour de leur compte Ranktracker.

Données complètes sur le classement du Top 100

Ranktracker est conçu pour assurer un suivi complet du Top 100.

Au lieu de s’arrêter à la première page de Google, Ranktracker suit les dix pages de résultats naturels. Cela vous aide à identifier les mots-clés qui commencent à gagner en visibilité avant même d’atteindre la première page.

Grâce à l’API, vous pouvez récupérer l’historique de classement le plus récent associé à un mot-clé suivi, y compris des informations telles que :

• Position organique actuelle
• Position absolue dans les SERP
• URL classée
• Évolution quotidienne du classement
• Évolution hebdomadaire du classement
• Évolution mensuelle du classement
• Volume de recherche
• Trafic estimé
• Coût par clic
• Concurrence
• Difficulté des mots-clés

Chaque mot-clé suivi peut également être associé au moteur de recherche, à la localisation, à la langue et à l’appareil configurés. Cela permet aux équipes de créer des rapports bien plus détaillés qu’une simple liste de positions de mots-clés.

Suivi dans plus de 107 000 localités

Ranktracker prend en charge plus de 107 000 emplacements suivis, ainsi que le suivi sur ordinateur et sur mobile, et offre une large couverture linguistique. L’API est donc adaptée à :

• Campagnes de référencement local
• Suivi des recherches au niveau national
• Référencement international
• Sites web multilingues
• Franchises et entreprises multi-sites
• Agences gérant des clients sur différents marchés

Un mot-clé peut être suivi selon de multiples combinaisons de localité, de langue et d’appareil.

Par exemple, une agence pourrait suivre le même mot-clé sur ordinateur et sur mobile à Londres, Manchester et Birmingham. Chaque combinaison est enregistrée dans une ligne de suivi distincte, ce qui offre à l’agence une vision plus précise des différences de performances de recherche selon les marchés.

Ce que vous pouvez faire avec l’API Ranktracker

L’API donne accès aux principales ressources utilisées dans un compte Ranktracker.

Gérer les domaines

Vous pouvez créer, récupérer, mettre à jour et supprimer des domaines suivis par programmation.

Cela permet d’intégrer Ranktracker à votre processus d’intégration des clients. Lorsqu’un client est ajouté à votre système interne, son domaine peut également être créé automatiquement dans Ranktracker.

Les points de terminaison au niveau du domaine fournissent également l'historique des classements et les données de part de voix sur une période sélectionnée. Les requêtes d'historique et de part de voix peuvent couvrir des périodes allant jusqu'à 365 jours et peuvent être filtrées par ordinateur de bureau, mobile ou tous les appareils. Gérer les concurrents

Ajoutez, récupérez, mettez à jour ou supprimez les concurrents associés à chaque domaine suivi.

Cette fonctionnalité permet de configurer automatiquement la surveillance des concurrents pour de nouveaux projets ou de synchroniser les paramètres client entre Ranktracker et une autre plateforme.

Ajouter et gérer des mots-clés

Créez des mots-clés à suivre pour un domaine et précisez leur moteur de recherche, leur emplacement, leur langue, leur appareil et leur fréquence de suivi.

L’API prend en charge la création en masse à l’aide d’une combinaison d’expressions-clés et de configurations de moteurs de recherche. Au lieu d’envoyer des centaines de requêtes individuelles, vous pouvez soumettre plusieurs mots-clés et configurations de suivi en une seule fois. Les mots-clés peuvent également être mis en pause, réactivés ou supprimés par programmation.

Récupérer l’historique des classements

Récupérez les derniers résultats de classement pour chaque mot-clé associé à un domaine.

Ces données peuvent être envoyées vers :

• Portails de reporting clients
• Google Sheets
• Entrepôts de données
• Tableaux de bord de veille stratégique
• Systèmes de notification internes
• Applications SEO personnalisées

La documentation comprend un tutoriel complet pour extraire les classements quotidiens et les charger dans un entrepôt de données ou un workflow basé sur des fichiers CSV. Accéder aux résultats SERP

Chaque mot-clé suivi donne accès à ses derniers résultats de recherche analysés.

Cela inclut les résultats naturels et les fonctionnalités SERP qui les entourent. Ranktracker suit des fonctionnalités telles que les extraits optimisés, les résultats cartographiques, les vidéos, les résultats Shopping, les résultats « Les internautes ont également demandé » et les aperçus IA. Le code HTML SERP mis en cache est également disponible pour les mots-clés suivis pris en charge. Cela signifie que vous pouvez analyser bien plus que le classement numérique d’un domaine.

Vous pouvez également comprendre quel type de résultat de recherche s’affiche, quels concurrents entourent votre fiche et quelles fonctionnalités de la SERP peuvent influencer les taux de clics organiques.

Créer des rapports sur la part de voix

L’endpoint « part de voix » renvoie un chiffre global de visibilité, son évolution sur la période sélectionnée et une série quotidienne comparant votre domaine à ses concurrents suivis.

Ces données sont déjà structurées pour la création de graphiques et de rapports. Vous pouvez les utiliser pour créer une courbe de visibilité indiquant si votre marque gagne ou perd du terrain par rapport aux domaines concurrents. Organisez les mots-clés à l’aide de balises

Créez des balises au niveau du compte et appliquez-les aux mots-clés de différents projets.

Les balises peuvent être utilisées pour distinguer :

• Mots-clés de marque et génériques
• Produits et services
• Pays ou localités
• Campagnes
• Mots-clés prioritaires
• Groupes de rapports clients
• Différentes sections d’un site web

L'API prend en charge le balisage en masse, ce qui permet d'appliquer un même balisage à plusieurs mots-clés en une seule requête. Suivre l'utilisation du compte

Le point de terminaison d’utilisation du compte indique la part de votre forfait déjà utilisée et la capacité restante.

Il indique les quotas, notamment :

• Mots-clés actifs
• Lignes de données
• Vérifications à la demande
• Crédits SERP Analyser

Chaque quota indique son utilisation actuelle, sa limite totale et la capacité restante. Cette fonctionnalité est particulièrement utile avant d’importer une liste de mots-clés volumineuse. Votre intégration peut d’abord vérifier la capacité disponible et éviter de tenter une importation qui dépasserait le quota du compte.

Conçue pour les agences

Les agences constituent l’un des principaux groupes pouvant tirer parti de la nouvelle API.

Un workflow d’intégration automatisé typique pourrait :

1. Créez le domaine du client.
2. Ajoutez ses concurrents.
3. Importez les mots-clés cibles.
4. Configurez les localisations, les langues et les appareils.
5. Créez des balises spécifiques au client.
6. Envoyer les données de classement vers un tableau de bord interne.
7. Générer des rapports de visibilité récurrents.

Un processus qui impliquait auparavant plusieurs étapes manuelles peut désormais être connecté au système de gestion de projet ou d’intégration des clients propre à l’agence.

Les agences peuvent également extraire des instantanés quotidiens de classement dans leur propre base de données et présenter ces informations au sein d’un portail en marque blanche.

Conçu pour les équipes SEO internes

Les équipes internes peuvent croiser les classements avec des données métier plus larges.

Par exemple, les performances des mots-clés peuvent être combinées avec :

• Clics sur Google Search Console
• Conversions sur le site web
• Chiffre d'affaires e-commerce
• Prospects générés
• Performance des pages de destination
• Dates de publication du contenu
• Mises à jour techniques SEO

Cela permet de dépasser facilement les rapports de classement isolés et de comprendre comment la visibilité sur les moteurs de recherche contribue aux résultats commerciaux globaux.

Conçu pour les plateformes de référencement et les développeurs

Les développeurs peuvent utiliser Ranktracker comme couche de données de classement et de SERP pour leurs outils internes ou leurs applications destinées aux clients.

L’API suit une structure REST cohérente, tous les points de terminaison de production utilisant :

https://api.ranktracker.com/v1

Les réponses utilisent un format de type JSON:API. Les ressources sont renvoyées sous la clé « data », leurs champs étant contenus dans un objet « attributes ». Les points de terminaison de liste prennent en charge la pagination jusqu’à 1 000 enregistrements par page et renvoient le nombre total via les en-têtes de réponse. La documentation fournit actuellement des exemples concrets pour :

• cURL
• Python
• Node.js

Elle comprend également des tutoriels complets couvrant la création de domaines, le suivi des mots-clés, les exportations vers un entrepôt de données, les rapports sur la part de voix et le marquage groupé de mots-clés.

Comment créer votre clé API

La mise en route ne nécessite que quelques étapes :

1. Connectez-vous à votre compte Ranktracker.
2. Ouvrez les paramètres de votre compte.
3. Accédez à la section « Clés API ».
4. Créez une nouvelle clé API.
5. Conservez cette clé en lieu sûr sur votre serveur.

Les clés API ont le format suivant :

tkn_usr_...

Votre clé doit être transmise directement dans l'en-tête « Authorization ». Elle ne nécessite pas de préfixe « Bearer ». Voici une requête de base qui répertorie les domaines de votre compte :

Une requête réussie renvoie les domaines détenus par le compte associé à cette clé.

Les clés API doivent toujours être traitées comme des mots de passe. Elles ne doivent pas être placées dans des dépôts publics, du code de navigateur ou des applications mobiles.

Conçue pour une automatisation fiable

L'API utilise des méthodes HTTP standard et des structures de réponse prévisibles.

Elle prend en charge :

• GET pour récupérer des ressources
• POST pour créer des ressources
• PATCH pour mettre à jour des ressources
• DELETE pour supprimer des ressources

Les erreurs comprennent des codes et des descriptions lisibles par machine, ce qui permet aux intégrations de déterminer si une requête doit être corrigée, si un compte a atteint sa limite d’utilisation ou si une requête temporaire doit être réessayée. Les opérations « k », la pagination et les rapports d’utilisation contribuent également à réduire les requêtes inutiles lors de la gestion de projets de grande envergure.

Une brève note sur le MCP

Ranktracker propose également une option de serveur MCP permettant de connecter des outils et assistants d’IA pris en charge aux données de Ranktracker.

Nous aborderons le serveur MCP, les outils pris en charge et la procédure de connexion dans un article distinct.

Commencez à développer avec l'API Ranktracker

L'API Ranktracker offre aux professionnels du référencement naturel un meilleur contrôle sur la manière dont ils collectent, organisent et exploitent leurs données de recherche.

Vous pouvez automatiser les workflows de suivi de positionnement, synchroniser des projets, récupérer les résultats complets du Top 100, analyser les fonctionnalités des SERP, comparer la part de voix et intégrer les données SEO dans les systèmes déjà utilisés par votre organisation.

Plus important encore, l'accès à l'API est désormais inclus dans toutes les formules Ranktracker.

Créez votre clé API depuis votre compte Ranktracker et consultez la documentation sur developers.ranktracker.com.