API Volia v1

Authentification

Toutes les requêtes nécessitent une clé API au format pk_xxxxxxxx, à passer dans le header Authorization: Bearer pk_xxx.

Créez une clé depuis Paramètres → API. Max 5 clés actives par compte. La clé n'est affichée qu'une seule fois à la création.

curl https://volia.fr/api/v1/me \
  -H "Authorization: Bearer pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Endpoints

{
  "user": {
    "id": "uuid",
    "email": "user@example.com",
    "created_at": "2026-01-15T10:00:00Z"
  },
  "plan": {
    "id": "solo",
    "name": "Solo",
    "limits": {
      "searches_per_month": 1000,
      "enrichments_per_month": 400,
      "exports_per_month": 50
    }
  },
  "usage": {
    "month": "2026-05",
    "searches": 234,
    "enrichments": 87,
    "exports": 12
  }
}

{
  "data": [
    {
      "id": "uuid",
      "nom": "Restaurant Le Bistrot",
      "adresse": "12 rue de Rivoli, 75001 Paris",
      "telephone": "+33 1 42 60 12 34",
      "email": "contact@bistrot.fr",
      "email_method": "scrape",
      "site_web": "https://bistrot.fr",
      "note": 4.5,
      "nb_avis": 234,
      "departement": "75",
      "search_session_id": "uuid",
      "created_at": "2026-05-20T14:30:00Z"
    }
  ],
  "pagination": {
    "total": 1234,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

{
  "month": "2026-05",
  "plan": { "id": "solo", "name": "Solo" },
  "usage": {
    "searches": {
      "used": 234,
      "limit": 1000,
      "percent": 23.4
    },
    "enrichments": { "used": 87, "limit": 400, "percent": 21.7 },
    "exports": { "used": 12, "limit": 50, "percent": 24.0 }
  }
}

Intégration Zapier

Volia ne dispose pas encore d'app native dans le Zapier directory. Vous pouvez néanmoins utiliser les Webhooks Premium de Zapier pour appeler nos endpoints :

1. Dans Zapier, créez un Zap avec action Webhooks by Zapier → GET
2. URL : https://volia.fr/api/v1/prospects?has_email=true&limit=10
3. Headers : Authorization: Bearer pk_votre_clé
4. Mappez ensuite les champs data[].email vers votre action suivante

Intégration Make (ex-Integromat)

Utilisez le module HTTP → Make a request :

Vous pouvez ensuite mapper data[] en boucle vers n'importe quel module (Google Sheets, HubSpot, Pipedrive, Notion, etc.).

Codes d'erreur

Limites & bonnes pratiques

• Les quotas du plan (searches, enrichments, exports) s'appliquent aussi à l'API.
• Limit max par page : 100. Utilisez offset pour paginer au-delà.
• Max 5 clés actives par compte. Révoquez les anciennes depuis Paramètres → API.
• Stockez les clés dans un gestionnaire de mots de passe ou dans les variables d'environnement de votre outil (Zapier, Make, etc.). Ne jamais commiter dans un repo public.
• En cas de fuite : révoquez immédiatement et créez une nouvelle clé.