Analytics
SE Ranking dans votre produit et vos agents IA, via une API
Le toolkit SE Ranking couvre les projets, les moteurs de recherche et mots-clés suivis, les positions des mots-clés et l'historique de classement, les concurrents, les audits de site web et les stats de backlinks. Avec Connect, votre produit ou agent IA appelle le tout par un seul endpoint, pendant que Connect stocke la clé d'API et journalise chaque exécution.
15 jours d'essai. Sans carte bancaire.
POST https://connect.reportei.com/api/tools/se_ranking_create_audit/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"domain": "<domain>"
}
}Fonctionnement
Du client connecté au premier appel à SE Ranking.
- 1
Votre client connecte son compte
Votre système ouvre une session Connect pour le toolkit et votre client connecte son compte SE Ranking. Vous recevez l'id de la connexion.
- 2
Votre produit appelle la tool
Un POST sur /api/tools/{tool}/execute avec l'id de la connexion et les arguments. En cas de succès, Connect conserve le statut et le corps de la réponse de l'app.
- 3
Connect s'occupe du reste
Il stocke l'identifiant chiffré, renouvelle les tokens des connexions OAuth qui le permettent et enregistre les exécutions dans un journal d'audit consultable via l'API.
Cas d'usage
Ce que votre produit fait avec SE Ranking.
Rapports SEO en marque blanche
Un outil d'agence lit le résumé d'un projet, les positions des mots-clés et l'historique de classement pour composer le rapport du client.
Comparer avec les concurrents
Un SaaS liste les concurrents d'un projet et obtient leurs positions sur les mêmes mots-clés sur une période.
Lancer et lire des audits de site
Un agent IA démarre l'audit d'un domaine puis lit son rapport, avec le score de santé et les erreurs, avertissements et notices.
Tools
12 tools SE Ranking
- Lister les projetsGETListe les projets du compte, chacun étant un site suivi, avec l'id que demandent les autres outils comme site_id, son titre, son URL, keyword_count, sa fréquence de vérification et le guest_link pour partager les classements sans connexion.
- Obtenir le résumé du projetGETRenvoie le résumé d'un projet : la position moyenne des deux dernières vérifications, combien de positions ont monté et baissé, les mots-clés dans le top 5, 10 et 30, la visibilité, le Domain Authority et les pages indexées dans Google.
- Lister les moteurs de recherche du projetGETListe les moteurs de recherche qu'un projet suit, chacun avec le site_engine_id que demandent les outils de classement, sa région, sa langue et keyword_count.
- Lister les mots-clésGETListe les mots-clés qu'un projet suit, avec id, name (le texte du mot-clé), lien cible, groupe et les site_engine_ids où il est suivi. Les outils de classement ne renvoient que l'id du mot-clé : c'est donc ici que se trouve le texte.
- Obtenir les positions des mots-clésGETRenvoie les positions des mots-clés d'un projet à chaque date de vérification d'une période, groupées par moteur de recherche, avec la variation, le volume de recherche et la concurrence de chacun. Les mots-clés arrivent par id : le texte se trouve dans Lister les mots-clés.
- Obtenir l'historique de classementGETRenvoie une série temporelle d'une métrique de classement d'un projet par date de vérification : une série par moteur de recherche et une avec la moyenne de tous. value arrive parfois en texte et parfois en nombre.
- Lister les concurrentsGETListe les concurrents ajoutés à un projet, avec l'id que demande Obtenir les positions du concurrent, leur nom, leur URL et leur Domain Trust.
- Obtenir les positions du concurrentGETRenvoie les positions d'un concurrent pour les mots-clés du projet à chaque date de vérification d'une période, groupées par moteur de recherche, avec le nom du mot-clé et le volume de recherche.
- Lister les auditsGETListe les audits de site du compte, avec id, url, titre, statut (comme processing ou finished), last_update et les dernières statistiques, et total comme nombre trouvé. La dernière page est celle où offset plus limit atteint total.
- Créer un auditPOSTDémarre l'audit de site d'un domaine et renvoie son id ; Obtenir le rapport d'audit affiche is_finished à la fin. Il utilise les limites d'audit du forfait et, par défaut, SE Ranking envoie le rapport par e-mail au propriétaire du compte à la fin, sauf si settings.send_report vaut 0.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
Questions sur le toolkit SE Ranking
Dois-je intégrer l'API SE Ranking moi-même ?
Non. Connect fournit 12 tools SE Ranking décrites et prêtes. Votre client connecte son compte et votre système appelle chaque tool par le même endpoint, avec le même format de requête.
Comment mon client connecte-t-il son compte SE Ranking ?
Avec le mode accepté par le toolkit : Clé d'API. Connect stocke l'identifiant chiffré et ne le renvoie jamais à votre système.
Est-ce compatible avec les agents IA ?
Oui. L'input de chaque tool est décrit en JSON Schema, que votre agent utilise directement comme définition de tool. L'agent choisit la tool et les arguments, et votre système fait l'appel à Connect.
Mon client doit-il avoir un compte Reportei ?
Non. Votre client connecte son compte sur un écran de Connect, ou votre système envoie l'identifiant via l'API, et il continue d'utiliser uniquement votre produit.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
