API Olenx

API REST publique pour les workspaces Agence et Enterprise. Exportez vos audits, projets et concurrents vers vos outils BI, dashboards Looker, ou scripts d'automatisation.

Authentication

Générez une clé API dans Paramètres → API & webhooks. Utilisez-la dans le header :

Authorization: Bearer ok_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Rate limit : 1000 requêtes / heure / clé.

Endpoints

GET/api/v1/projects

Liste tous vos projets actifs.

Voir exemple de réponse

{
  "data": [
    {
      "id": "uuid",
      "name": "Castalie",
      "brand_name": "Castalie",
      "country": "France",
      "target_persona": "...",
      "audit_status": "COMPLETED",
      "last_audit_at": "2026-05-01T10:00:00Z",
      "next_audit_at": "2026-05-08T10:00:00Z",
      "mention_rate": 47,
      "created_at": "2026-04-15T..."
    }
  ]
}

GET/api/v1/audits

Liste les résultats d'audit (multi-LLM × multi-prompts).

Params :

project_id — Filtrer par projet (uuid)
limit — Max 500 (défaut 50)
offset — Pour pagination
since — ISO date — résultats après cette date

Voir exemple de réponse

{
  "data": [
    {
      "id": "uuid",
      "project_id": "uuid",
      "prompt": "Quels sont les meilleurs traiteurs éco-responsables ?",
      "llm": "openai",
      "cited": "yes",
      "citation_frequency": 0.6,
      "competitors": ["Wisecup", "Foodles"],
      "sources": [...],
      "created_at": "..."
    }
  ],
  "pagination": { "offset": 0, "limit": 50, "count": 1234 }
}

GET/api/v1/competitors

Liste tous les concurrents trackés (par projet ou cross-projets).

Params :

project_id — Filtrer par projet (optional)

Voir exemple de réponse

{
  "data": [
    { "name": "Wisecup", "project_id": "uuid" },
    { "name": "Foodles", "project_id": "uuid" }
  ]
}

Codes d'erreur

Code HTTP	Erreur	Description
401	UNAUTHENTICATED	Bearer token manquant ou invalide.
401	INVALID_API_KEY	Clé révoquée ou inexistante.
402	PLAN_NOT_ELIGIBLE	API publique requiert Agence+.
429	RATE_LIMIT_EXCEEDED	Plus de 1000 req/heure sur cette clé.

Exemple curl

curl -H "Authorization: Bearer ok_live_xxx" \
  https://app.olenx.com/api/v1/audits?limit=10

Intégration Zapier & Make

Olenx ne dispose pas (encore) d'app officielle Zapier ou Make, mais vous pouvez tout connecter en 5 minutes en combinant nos webhooks (events sortants) et notre API REST (lecture data) avec les modules génériques de ces plateformes.

Pattern 1Webhook Olenx → Zapier/Make → action ailleurs

Idéal pour réagir en temps réel aux events Olenx (audit terminé, citation détectée, mouvement concurrent).

Zapier : créer un Zap, choisir trigger « Webhooks by Zapier » → « Catch Hook ». Zapier vous donne une URL.
Make : créer un scenario, ajouter module « Webhooks » → « Custom Webhook ». Make vous donne une URL.
Dans Olenx → Paramètres → API & webhooks → coller l'URL dans « Webhook générique » → cocher les events souhaités → Save.
Cliquez « Tester » dans Olenx. Vérifiez que Zapier/Make a reçu le payload.
Branchez n'importe quelle action : Slack message, Asana task, HubSpot deal update, Notion row, Google Sheets append, SMS Twilio, etc.

Voir la structure du payload

{
  "event": "audit_completed",
  "workspaceId": "uuid",
  "projectId": "uuid",
  "url": "https://app.olenx.com/audit?project=...",
  "message": "Audit terminé pour Castalie · 47% citation rate",
  "timestamp": "2026-05-09T14:32:11Z"
}

Pattern 2Zapier/Make → API Olenx (lecture programmée)

Idéal pour pull les données Olenx vers vos outils (rapport hebdo, sync vers BI, dashboards custom).

Zapier : trigger « Schedule by Zapier » (ex : tous les lundis 9h) → action « Webhooks by Zapier » → « Custom Request » GET.
Make : trigger « Scheduler » → module « HTTP » → « Make a request ».
URL : https://app.olenx.com/api/v1/audits?limit=100&since=2026-05-01
Headers : Authorization: Bearer ok_live_xxx (votre clé API Olenx)
Branchez la sortie (JSON) vers : Google Sheets row append, Airtable record, Notion database, email rapport, etc.

Cas d'usage concrets

Marketing manager — Slack alert quand citation rate Castalie passe sous 30% · Pattern 1, filter Zapier sur citation_frequency
CSM agence — Crée tâche Asana auto à chaque audit hebdo client · Pattern 1, action Asana « Create Task »
Data analyst — Sync data Olenx vers Airtable chaque nuit · Pattern 2, scheduler quotidien + Airtable bulk insert
Sales — Push fiche HubSpot du prospect quand mouvement concurrent · Pattern 1, filter Zapier sur event = competitor_movement
Founder — Rapport email perso lundi 8h avec MRR + audits + alertes · Pattern 2, scheduler + email Gmail

Vous avez construit une recette Zapier/Make utile ? Partagez-la avec contact@olenx.com — on l'ajoute à la doc et on créditera votre workspace.

← Voir toutes les intégrations · Documentation