---
title: API Mirubiki en Python : lancer un sondage depuis un script
description: Créer une clé API, lancer un sondage en Python, attendre la fin du traitement et récupérer les résultats : l'exemple complet, du POST au statut « completed ».
---

# API Mirubiki en Python : lancer un sondage depuis un script

Publié le 2026-07-29

### 1. Créer une clé API

Dans votre tableau de bord Mirubiki, allez dans **[Clés API](/api-keys)** (plan Enterprise requis).

1. Cliquez sur **« + Créer une clé »**
2. Donnez un nom à votre clé (ex: « Script production »)
3. Copiez la clé générée — elle ne sera plus affichée après fermeture

### 2. Exemple Python

```python
import requests
import time

API_KEY = "votre_cle_api"
BASE_URL = "https://www.mirubiki.com/api/v1"
HEADERS = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

# ─── Créer un sondage ───
survey = requests.post(f"{BASE_URL}/surveys", headers=HEADERS, json={
    "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": "Pourquoi ?", "type": "libre"},
    ],
    "nb_personas": 50,
    "filtres": {"age": ["25-34"], "sex": "F"},
})
sid = survey.json()["data"]["id"]
print(f"Sondage créé : {sid}")

# ─── Lancer le sondage ───
requests.post(f"{BASE_URL}/surveys/{sid}/launch", headers=HEADERS)
print("Sondage lancé, traitement en cours...")

# ─── Attendre la fin ───
while True:
    r = requests.get(f"{BASE_URL}/surveys/{sid}/status", headers=HEADERS)
    status = r.json()["data"]["status"]
    if status == "completed":
        break
    print("  statut:", status)
    time.sleep(5)

# ─── Récupérer les résultats ───
results = requests.get(f"{BASE_URL}/surveys/{sid}/results", headers=HEADERS)
print("Résultats reçus :")
print(results.json())
```

### 3. Documentation complète

Tous les endpoints (sondages, focus groups, gestion des clés) sont décrits dans la **[documentation complète de l'API](/blog/api-documentation)**.

**À lire aussi** : [La documentation de l'API](/blog/api-documentation) · [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": "API Mirubiki en Python : lancer un sondage depuis un script", "description": "Créer une clé API, lancer un sondage en Python, attendre la fin du traitement et récupérer les résultats : l'exemple complet, du POST au statut « completed ».", "datePublished": "2026-07-29", "dateModified": "2026-07-29", "inLanguage": "fr-FR", "mainEntityOfPage": {"@type": "WebPage", "@id": "https://www.mirubiki.com/blog/2026-07-29-utiliser-api-mirubiki-depuis-python"}, "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": "API Mirubiki en Python : lancer un sondage depuis un script", "item": "https://www.mirubiki.com/blog/2026-07-29-utiliser-api-mirubiki-depuis-python"}]}]}
```