L’API SEO de Ranxplorer permet d’accéder à vos données SEO de manière automatisée, directement depuis vos propres outils, scripts ou dashboards. Ce tutoriel vous accompagne dans vos premiers pas avec l’API en vous montrant comment :
- Générer une clé API personnelle,
- Réaliser un premier appel à l’API avec un exemple concret,
- Intégrer l’API dans un workflow ou outil existant (par exemple : plateforme netlinking, plateforme de domaines)
Objectif : vous permettre d’utiliser l’API de manière simple et rapide, avec un cas concret.
Note : pour une présentation complète des fonctionnalités de l’API, de sa tarification et des cas d’usage avancés, consultez la page officielle de l’API Ranxplorer.
1. Créer une clé API Ranxplorer
Avant de pouvoir interroger l’API, vous devez générer une clé d’authentification (token). Cette clé est personnelle et permet d’identifier vos requêtes.
Étapes :
- Connectez-vous à votre compte Ranxplorer.
- Accédez à l’onglet dédié à l’API de votre espace utilisateur et récupérez votre clé API.
Si vous n’avez pas encore de compte, vous pouvez tester Ranxplorer gratuitement pendant 7 jours, sans engagement, avec 10 000 crédits offerts, ou acheter un pack de crédits API indépendamment de votre abonnement Ranxplorer, selon vos besoins.
2. Faire un premier appel à l’API
Une fois votre token API récupéré, vous pouvez effectuer votre première requête.
L’exemple ci-dessous interroge l’endpoint /v1/seo pour récupérer les données SEO disponibles pour un domaine.
Exemple avec cURL
curl --request GET \
--get "https://api.ranxplorer.com/v1/seo?search=www.ranks.fr&limit=2" \
--header "Accept: application/json" \
--header "X-Ranxplorer-Token: VOTRE_TOKEN_API"
Remplacez VOTRE_TOKEN_API par votre token personnel.
Comprendre la requête
GET /v1/seo: endpoint utilisé pour récupérer les données SEO.search=www.ranks.fr: domaine analysé.limit=2: nombre de résultats demandés.X-Ranxplorer-Token: authentifie votre requête.
L’API renvoie les résultats au format JSON, accompagnés de métadonnées sur la requête et la consommation de crédits.
Si la requête fonctionne, vous pouvez reprendre cet appel dans votre propre script, application ou workflow.
Conseil : testez d’abord cette requête dans Postman pour vérifier votre token et comprendre la structure de la réponse avant de passer à l’intégration.
3. Intégrer l’API dans vos outils
Une fois votre première requête validée, vous pouvez connecter Ranxplorer à vos outils et automatiser la récupération de vos données SEO.
Quelques cas d’usage
- Reporting SEO : alimenter automatiquement un dashboard dans Data Studio ou un rapport client.
- Suivi des positions : surveiller l’évolution d’un portefeuille de mots-clés.
- Analyse concurrentielle : récupérer régulièrement les données de vos concurrents.
- Recherche de mots-clés : exploiter les mots-clés associés, les SERP ou les questions PAA.
- Automatisation : envoyer les données vers une base de données, Google Sheets ou un outil métier.
- Workflows no-code : connecter Ranxplorer à Make, n8n ou Zapier.
Utiliser Ranxplorer avec une IA grâce au MCP
Ranxplorer propose également un serveur MCP (Model Context Protocol) qui permet aux assistants IA compatibles d’accéder aux données SEO de Ranxplorer via l’API.
Le principe est simple : au lieu de développer vous-même les requêtes API, vous pouvez interagir avec les données Ranxplorer directement depuis votre assistant IA.
Par exemple, vous pouvez demander à l’IA d’analyser la visibilité d’un domaine, d’explorer ses mots-clés ou d’étudier ses concurrents, selon les fonctionnalités disponibles via le serveur MCP.
API ou MCP ?
- Utilisez l’API pour intégrer les données Ranxplorer dans votre propre application, script ou workflow.
- Utilisez le MCP pour donner à un assistant IA un accès direct aux données Ranxplorer et les exploiter en langage naturel.
Dans les deux cas, les données proviennent de Ranxplorer : le choix dépend principalement de la manière dont vous souhaitez les exploiter.
Comment l’intégrer ?
L’API fonctionne avec des requêtes HTTP et peut donc être utilisée depuis un script, une application ou un outil capable d’effectuer des appels API.
Le principe est simple :
API Ranxplorer → récupération des données → traitement → votre outil
Par exemple, vous pouvez récupérer chaque mois les données SEO d’un site, les enregistrer dans une base de données, puis les afficher dans votre dashboard.
Pour une intégration plus avancée, consultez la documentation API complète de chaque endpoint afin de choisir les données et les paramètres adaptés à votre besoin.
La flexibilité de l’API vous permet d’adapter facilement son usage à vos projets internes, qu’il s’agisse de reporting client, d’analyse concurrentielle ou de génération de contenu.
5. Bonnes pratiques pour démarrer
Tester vos requêtes avec Postman
Avant d’intégrer l’API dans votre code ou votre workflow, testez vos requêtes avec Postman. Cela permet de vérifier rapidement :
- que votre token est valide ;
- que l’endpoint et la méthode HTTP sont corrects ;
- que les paramètres sont correctement renseignés ;
- que la réponse JSON correspond à vos attentes ;
- combien de crédits sont consommés par la requête.
Commencez par une requête simple, puis ajoutez progressivement les paramètres nécessaires.
Protéger votre token API
Votre token est personnel. Ne l’intégrez pas directement dans un dépôt Git, un script public ou un fichier partagé.
Privilégiez une variable d’environnement ou un gestionnaire de secrets :
RANXPLORER_TOKEN="votre_token"
Dans Postman, vous pouvez également utiliser une variable d’environnement :
X-Ranxplorer-Token: {{RANXPLORER_TOKEN}}
Maîtriser votre consommation de crédits
Toutes les requêtes ne consomment pas le même nombre de crédits. Vérifiez la tarification de l’endpoint utilisé avant de lancer des traitements importants.
Les réponses de l’API indiquent notamment les crédits consommés et le solde restant. Vous pouvez donc suivre automatiquement votre consommation dans votre application.
Évitez également de demander plus de résultats que nécessaire. Utilisez limit lorsque le paramètre est disponible.
Respecter la limite de requêtes
L’API est limitée à 120 requêtes par minute. Si votre application effectue de nombreuses requêtes, prévoyez une gestion du débit afin d’éviter les erreurs liées au rate limit.
Pour les traitements volumineux, privilégiez lorsque cela est possible les endpoints ou mécanismes prévus pour le traitement par lots.
Commencer par un endpoint simple
Pour une première intégration, commencez par un endpoint facile à tester, par exemple :
GET /v1/seo
Validez d’abord le fonctionnement de l’authentification et la structure de la réponse avant d’intégrer des endpoints plus complexes.
Vérifier les données avant de les automatiser
Lorsque vous construisez un workflow, vérifiez d’abord manuellement les résultats obtenus.
Cela permet de confirmer :
- le périmètre analysé ;
- la période sélectionnée ;
- le type de données retournées ;
- le nombre de résultats ;
- la consommation de crédits.
Une fois ces éléments validés, vous pouvez automatiser le traitement en toute sécurité.
Vérifier la documentation avant chaque intégration
Les endpoints, paramètres et modalités de facturation peuvent évoluer. Avant de développer une nouvelle intégration, consultez la documentation officielle de l’API Ranxplorer et vérifiez les paramètres disponibles pour l’endpoint concerné.
Vous pouvez aussi monitorer votre utilisation de crédits API directement de la page gestion API de votre compte Ranxplorer.