--- title: Documentation API Mirubiki description: Les endpoints de l'API Mirubiki (sondages, focus groups, clés), les formats de réponse et un exemple de bout en bout pour intégrer vos études. --- # Documentation API Mirubiki Publié le 2026-07-21 L'API REST de Mirubiki permet de créer, lancer et récupérer les résultats de sondages par IA de manière programmatique. ### Authentification Tous les appels nécessitent une clé API transmise via le header `X-API-Key`.

curl -H "X-API-Key: mirubi...cle" https://www.mirubiki.com/api/v1/surveys

Les clés sont disponibles depuis votre [tableau de bord API](/api-keys) (plans Enterprise et Admin uniquement). ### Rate Limiting | Plan | Limite | Fenêtre | |------|--------|---------| | Enterprise | 100 requêtes | 1 minute glissante | | Admin | 500 requêtes | 1 minute glissante | En cas de dépassement, l'API retourne `429 Too Many Requests` avec un header `X-RateLimit-Reset`. ### Réponses Toutes les réponses suivent le format : ``` { "data": { ... }, "error": null } # Succès { "data": null, "error": "Message d'erreur" } # Erreur ``` ### 🔑 Gestion des clés

GET /api/v1/api-keys

Liste les clés API de votre compte.

curl -H "X-API-Key: ***" https://www.mirubiki.com/api/v1/api-keys

POST /api/v1/api-keys

Crée une nouvelle clé API.

curl -X POST -H "X-API-Key: ***" \
  -H "Content-Type: application/json" \
  -d '{"nom": "Ma clé de production"}' \
  https://www.mirubiki.com/api/v1/api-keys

DELETE /api/v1/api-keys/{id}

Révoque une clé API.

curl -X DELETE -H "X-API-Key: ***" \
  https://www.mirubiki.com/api/v1/api-keys/42

### 📋 Sondages

POST /api/v1/surveys

Crée un sondage (brouillon).

curl -X POST -H "X-API-Key: ***" \
  -H "Content-Type: application/json" \
  -d '{
    "titre": "Test produit",
    "contexte": "Nous lançons un nouveau produit...",
    "questions": [
      { "texte": "Acheteriez-vous ce produit ?", "type": "choix_unique", "options": ["Oui","Non","Peut-être"] },
      { "texte": "Quel prix seriez-vous prêt à payer ?", "type": "libre" }
    ],
    "nb_personas": 50,
    "filtres": { "age": ["25-34"], "sex": "F" }
  }' \
  https://www.mirubiki.com/api/v1/surveys

POST /api/v1/surveys/{id}/launch

Lance un sondage (brouillon → en cours).

curl -X POST -H "X-API-Key: ***" \
  https://www.mirubiki.com/api/v1/surveys/abc123/launch

GET /api/v1/surveys/{id}/status

Récupère le statut et la progression d'un sondage.

curl -H "X-API-Key: ***" \
  https://www.mirubiki.com/api/v1/surveys/abc123/status

GET /api/v1/surveys/{id}/results

Récupère les résultats d'un sondage terminé.

curl -H "X-API-Key: ***" \
  https://www.mirubiki.com/api/v1/surveys/abc123/results

GET /api/v1/surveys

Liste les sondages de votre compte (paginé).

curl -H "X-API-Key: ***" \
  "https://www.mirubiki.com/api/v1/surveys?limit=20&offset=0"

DELETE /api/v1/surveys/{id}

Supprime un sondage.

curl -X DELETE -H "X-API-Key: ***" \
  https://www.mirubiki.com/api/v1/surveys/abc123

### 👥 Focus Groups Les Focus Groups sont des discussions de groupe avec 2 à 8 personas, modérées par IA.

POST /api/v1/focus

Crée un focus group.

curl -X POST -H "X-API-Key: ***" \
  -H "Content-Type: application/json" \
  -d '{
    "titre": "Avis sur email assurance",
    "guide": "Comparer deux propositions",
    "nb_personas": 4,
    "max_turns": 6,
    "filtres": { "sexe": "F", "ages": ["25-40"] }
  }' \
  https://www.mirubiki.com/api/v1/focus

GET /api/v1/focus

Liste les focus groups (paginé).

curl -H "X-API-Key: ***" \
  "https://www.mirubiki.com/api/v1/focus?limit=20&offset=0"

GET /api/v1/focus/{id}

Détails d'une session focus group.

curl -H "X-API-Key: ***" \
  https://www.mirubiki.com/api/v1/focus/abc123

GET /api/v1/focus/{id}/transcript

Transcript texte de la discussion.

curl -H "X-API-Key: ***" \
  https://www.mirubiki.com/api/v1/focus/abc123/transcript

DELETE /api/v1/focus/{id}

Supprime un focus group.

curl -X DELETE -H "X-API-Key: ***" \
  https://www.mirubiki.com/api/v1/focus/abc123

**À lire aussi** : [L'API depuis Python](/blog/2026-07-29-utiliser-api-mirubiki-depuis-python) · [Créer votre premier sondage](/blog/2026-06-12-creer-premier-sondage) *Mirubiki interroge 25 profils représentatifs de la population française en quelques minutes — [testez votre idée](/).* ```json {"@context": "https://schema.org", "@graph": [{"@type": "Article", "headline": "Documentation API Mirubiki", "description": "Les endpoints de l'API Mirubiki (sondages, focus groups, clés), les formats de réponse et un exemple de bout en bout pour intégrer vos études.", "datePublished": "2026-07-21", "dateModified": "2026-07-21", "inLanguage": "fr-FR", "mainEntityOfPage": {"@type": "WebPage", "@id": "https://www.mirubiki.com/blog/api-documentation"}, "author": {"@type": "Person", "@id": "https://www.mirubiki.com/auteur#person", "name": "Bertrand Jesenberger", "url": "https://www.mirubiki.com/auteur"}, "publisher": {"@type": "Organization", "name": "Mirubiki", "logo": {"@type": "ImageObject", "url": "https://www.mirubiki.com/static/mirubiki-logo.png"}}}, {"@type": "BreadcrumbList", "itemListElement": [{"@type": "ListItem", "position": 1, "name": "Accueil", "item": "https://www.mirubiki.com/"}, {"@type": "ListItem", "position": 2, "name": "Blog", "item": "https://www.mirubiki.com/blog"}, {"@type": "ListItem", "position": 3, "name": "Documentation API Mirubiki", "item": "https://www.mirubiki.com/blog/api-documentation"}]}]} ```