Trois façons de construire sur vos données de visibilité IA

Oui. L’API de visibilité dans la recherche IA renvoie du JSON sur du REST classique, donc tout ce qui peut appeler un point de terminaison HTTP peut la lire : Looker Studio, Power BI, Tableau, Metabase, ou un job d’entrepôt de données planifié. Récupérez scores de visibilité, taux de mention, positions et sources citées par marque et par moteur, puis croisez-les avec vos propres tables. Des clés en lecture seule à portée restreinte (`read:brands`, `read:reports`) garantissent qu’un connecteur BI n’a jamais d’accès en écriture.

La référence complète se trouve sur /docs/v1/, générée à partir d’une spécification OpenAPI 3.1. Chaque point de terminaison documente ses paramètres, son schéma de réponse et ses codes d’erreur, avec des exemples exécutables en curl, JavaScript (fetch) et Python (httpx). Comme la spécification est lisible par machine, vous pouvez aussi générer un client typé dans n’importe quel langage avec openapi-generator, Stainless, Speakeasy ou Fern.

Oui. Une seule requête renvoie des données de visibilité IA pour les sept moteurs : ChatGPT, Claude, Gemini, Perplexity, Google AI Mode (AI Overviews), Muse et Grok. Ils sont normalisés dans un seul schéma, ce qui vous permet de comparer positions et citations entre moteurs sans écrire de parseurs par plateforme ni maintenir six scrapers différents.

Oui. Les données concurrentielles de visibilité dans la recherche IA font partie du contenu du rapport : en plus de votre propre marque, les rapports renvoient les marques concurrentes citées par chaque moteur pour le même prompt, leur position dans la réponse et les sources citées pour elles. Cela vous permet de suivre votre part de voix dans le temps et d’être alerté quand un concurrent vous dépasse sur une catégorie.

Presque. Les rapports s’exécutent à la demande ou selon une planification, et des webhooks sortants envoient `report.completed`, `report.failed`, `schedule.run.completed` et `schedule.run.failed` à votre point de terminaison dès qu’une exécution se termine, avec des payloads signés HMAC. Vous n’avez pas besoin de faire du polling : vos systèmes apprennent l’existence de nouvelles données de visibilité IA dès qu’elles existent.

Oui. La restriction de clé par marque vous permet de générer une clé limitée à une seule marque, ce qui rend possibles les tableaux de bord entreprise en marque blanche par client : chaque client ne voit que ses propres données de visibilité IA. Combinée à des permissions à portée restreinte, des écritures idempotentes et un format d’erreur stable, l’API est conçue pour soutenir des intégrations personnalisées en production.

La gestion des marques (créer, lister, récupérer, mettre à jour, supprimer), des rapports de visibilité IA sur les sept principales plateformes LLM, le suivi des citations et des sources avec le Rank Prompt Score, des rapports planifiés, des webhooks sortants, ainsi que les points de terminaison de compte (`/v1/me`, `/v1/me/quota`). Vous pouvez aussi connecter un client MCP. Les audits de marque, la génération de contenu optimisé pour l’IA, les audits SEO techniques et l’outreach figurent sur la roadmap publique et sortiront sous le même contrat /v1 ; abonnez-vous au journal des modifications pour suivre les dates de sortie. La surface finale reproduira le tableau de bord à l’identique.

Tous les forfaits incluent l’accès à l’API développeur, y compris le gratuit, vous pouvez donc générer une clé directement depuis la page Développeurs de votre espace de travail. Vous voulez un quota dédié plus important ? Abonnez-vous à un forfait autonome API Starter ou API Pro. Chaque clé porte des permissions délimitées (par exemple `read:brands`, `write:brands`) et une restriction de marque optionnelle pour un usage en marque blanche. Les clés ont le préfixe `rp_live_`, ne s’affichent qu’une fois à la création et sont stockées hachées en base.

L’accès à l’API développeur est inclus dans tous les forfaits, avec un plafond mensuel de requêtes par palier : 1 000 sur Free, 10 000 sur Starter, 25 000 sur Pro, 50 000 sur Agency et 100 000 sur Agency Plus. Les endpoints /v1 qui consomment des crédits (ceux qui appellent un LLM payant ou un backend de recherche tiers) sont débités de votre solde de crédits, vous ne payez donc jamais deux fois ; sur Free il n’y a pas de crédits mensuels, vous rechargez donc avant tout travail facturable. Vous voulez un quota dédié plus important ? Deux abonnements autonomes couvrent cela : API Starter (99 $/mois, 50 000 unités de requête, 500 crédits API inclus) et API Pro (299 $/mois, 200 000 unités de requête, 2 000 crédits API inclus). Chaque forfait applique une limite de 120 requêtes/minute par clé, et la carte des coûts par endpoint est dans la documentation développeur.

Non. L’accès à l’API développeur est inclus dans votre forfait, avec un plafond mensuel de requêtes qui évolue par palier (1 000 sur Free, puis 10 000 / 25 000 / 50 000 / 100 000). Les endpoints /v1 qui consomment des crédits utilisent les mêmes crédits mensuels que vous payez déjà, il n’y a donc rien de plus à acheter. Vous n’ajouteriez un forfait autonome API Starter ou API Pro que si vous voulez un quota de requêtes dédié plus important avec ses propres crédits API inclus.

Une limite de 120 requêtes par minute glissante s’applique à chaque clé API, quel que soit le forfait. En plus de cela, votre forfait accorde un quota mensuel d’unités de requête. Le quota appartient au compte : chaque clé créée dans ce compte, la vôtre comme celles de votre équipe, puise dans le même quota, et le propriétaire du compte les voit toutes et peut en révoquer n’importe laquelle. Chaque réponse mesurée inclut `X-RP-Quota-Limit`, `X-RP-Quota-Used`, `X-RP-Quota-Remaining` et `X-RP-Quota-Reset` pour gérer votre rythme sans faire de polling. Les appels limités renvoient un 429 avec `Retry-After`.

Pas encore. L’API est livrée avec une spécification OpenAPI 3.1, vous pouvez donc générer des clients idiomatiques dans n’importe quel langage avec openapi-generator, oazapfts, hey-api, Stainless, Speakeasy ou Fern. La documentation inclut des exemples curl, JavaScript (fetch) et Python (httpx) pour chaque point de terminaison. Des SDK officiels TypeScript et Python figurent sur la roadmap.

Les points de terminaison `GET /v1/me` et `GET /v1/me/quota` coûtent 0 unité de requête et ne comptent jamais dans votre quota, vous pouvez donc valider clés, portées et signature des requêtes sans consommer de budget. Pour des tests de bout en bout complets, générez une clé séparée avec des portées limitées et utilisez-la sur une marque de test.

Le contrat /v1 est additif. Nous n’ajoutons que des champs et des points de terminaison ; nous ne les supprimons ni ne les renommons jamais silencieusement. Quand un changement cassant est inévitable, nous livrons /v2 en parallèle de /v1 avec une longue fenêtre de dépréciation, et nous annonçons le retrait de tout point de terminaison via l’en-tête HTTP standard `Sunset`, bien à l’avance.

Oui. Liez, si vous le souhaitez, une clé à une seule marque à sa création (`allowed_brand_id`). L’API refusera toute requête dont la marque cible ne correspond pas, même si la clé appelante porte `write:all`. Cela permet aux agences et aux plateformes d’émettre des clés par marque à leurs clients sans créer un nouvel espace de travail Rank Prompt.

Oui, les webhooks sont disponibles. Enregistrez un point de terminaison par marque avec `POST /v1/brands/{brand_id}/webhooks` et abonnez-vous à `report.completed`, `report.failed`, `schedule.run.completed`, `schedule.run.failed` et `local_rank.dropped` (la position Maps d’un établissement a baissé). Les payloads sont signés HMAC, le secret de signature effectue une rotation (l’ancien secret reste valide 24 heures), et un point de terminaison se désactive automatiquement après des échecs répétés. Vous n’avez plus besoin de faire du polling sur le statut du rapport depuis un worker.

Oui. Le serveur MCP de Rank Prompt permet à Claude Code, Cursor, Claude Desktop ou tout client MCP de lire vos rapports, vos marques et vos citations, et de lancer des rapports en votre nom. Vous vous connectez via OAuth dans le navigateur, il n’y a donc aucune clé à coller. Consultez la page du serveur MCP sur rankprompt.com/mcp pour la configuration en 30 secondes.

Authentification par bearer token sur TLS, à portée restreinte par ressource. Les appels CORS depuis le navigateur sont bloqués en périphérie : l’API fonctionne uniquement de serveur à serveur. Les clés sont stockées hachées et nous soumettons le préfixe `rp_live_` au scan de secrets de GitHub, si bien que les clés divulguées sont détectées automatiquement. L’API tourne sur la même infrastructure durcie que le reste de la plateforme Rank Prompt, avec des options de résidence des données en UE/US.