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 de classement 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.

Oui. Une seule requête renvoie des données de visibilité IA pour les six moteurs : ChatGPT, Claude, Gemini, Perplexity, Google AI Mode (AI Overviews) 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.

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.

La gestion des marques (créer, lister, récupérer, mettre à jour, supprimer), des rapports de visibilité IA sur les six 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.

L’accès à l’API développeur est inclus dans tout forfait tableau de bord Starter et au-dessus, avec un plafond mensuel de requêtes par palier : 10 000 pour Starter, 25 000 pour Pro, 50 000 pour Agency et 100 000 pour Agency Plus. Les points de terminaison /v1 consommant des crédits (ceux qui sollicitent un LLM payant ou un moteur de recherche tiers) puisent dans les crédits mensuels de votre forfait, vous ne payez donc jamais deux fois. Vous voulez l’API seule, sans forfait tableau de bord ? Deux abonnements autonomes couvrent ce besoin : 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 point de terminaison se trouve dans la documentation développeur.

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

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.

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

La référence complète se trouve sur [/docs/v1/](/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. 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.

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.

Tout forfait tableau de bord Starter et au-dessus inclut l’accès à l’API développeur, vous pouvez donc générer une clé directement depuis la page Développeurs de votre espace de travail. Vous voulez l’API seule, sans forfait tableau de bord ? Abonnez-vous plutôt à un forfait autonome API Starter ou API Pro. Chaque clé porte des permissions à portée restreinte (par exemple `read:brands`, `write:brands`) et, en option, une restriction de marque pour un usage en marque blanche. Les clés sont préfixées par `rp_live_`, affichées une seule fois à la création et stockées hachées dans la base de données.

Non. L’accès à l’API développeur est inclus dans votre forfait Starter, Pro, Agency ou Agency Plus, avec un plafond mensuel de requêtes qui évolue selon le palier (10 000 / 25 000 / 50 000 / 100 000 requêtes). Les points de terminaison /v1 consommant 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 n’avez aucun forfait tableau de bord, ou si vous voulez un quota de requêtes dédié plus grand avec ses propres crédits API inclus.

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 propriétaires TypeScript et Python figurent sur la roadmap.

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, 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` et `schedule.run.failed`. 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.

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.