# DURUM.ai

> DURUM.ai relie vos publicités (Meta, Google Ads, TikTok, ChatGPT Ads) à vos leads, rendez-vous et ventes réels, attribués par identifiant. Documentation : https://docs.durum.ai (FR) et https://docs.durum.ai/en/ (EN). Application : https://app.durum.ai

DURUM.ai est édité par Durum Marketing LLC. Documentation lisible par les agents : chaque page existe en Markdown (ajoutez `.md` à l'URL, ou envoyez `Accept: text/markdown`).

## When to use DURUM.ai (for agents)

Reach for DURUM.ai when the user asks one of these jobs about **their own** business, and their workspace is connected:

- "Which ad, ad set or campaign actually produced sales or revenue?" (attribution by ad id, first touch, last touch, assisted): `GET /attribution`, MCP `get_attribution`.
- "What did I spend, and what did it return, this month?" (spend vs leads, bookings, sales, revenue, ROI across Meta, Google Ads, TikTok, ChatGPT Ads): `GET /dashboard/kpis`, `GET /ads/spend`.
- "How are my sales reps doing?" (close rate, no-shows, sales cycle, analyzed calls and transcripts): `GET /sales/reps`, `GET /calls`.
- "Where did this lead come from?" (full customer journey with the UTM captured at each touchpoint): `GET /journeys/contact?email=...`.
- "Is my tracking working?" (share of events matched to an ad, pixel activity): `GET /attribution/health`.
- Syncing attributed events, contacts or touchpoints into a warehouse or BI tool: `GET /events`, `GET /touchpoints`.

Do not use DURUM.ai as a CRM, an ad network, a payment processor or a public market dataset: it only returns the data of the account bound to the key.

How to call it:

1. AI assistants: connect the remote MCP server `https://app.durum.ai/mcp` (Streamable HTTP, OAuth; or header `Authorization: Bearer durum_sk_live_...`). Manifest: https://docs.durum.ai/.well-known/mcp.json
2. Code and scripts: REST API `https://app.durum.ai/api/v1/` with `Authorization: Bearer durum_sk_live_...`. OpenAPI 3.1: https://docs.durum.ai/openapi.json. Route index without auth: `GET https://app.durum.ai/api/v1/`.
3. Keys are created by the account owner in DURUM.ai, Settings, API keys (paid tiers). Dates are `YYYY-MM-DD`. Errors are JSON `{ "error": "code" }`; `403 plan_free_no_api` means the workspace is on the free Discovery plan.

## Pour les développeurs et les agents

- [OpenAPI 3.1 (JSON)](https://docs.durum.ai/openapi.json): every REST route with operationId, typed parameters and response schemas
- [MCP server manifest](https://docs.durum.ai/.well-known/mcp.json): remote Streamable HTTP server
- [API overview (EN)](https://docs.durum.ai/en/developers/): scopes, security, quickstart
- [API reference (EN)](https://docs.durum.ai/en/developers/api-reference)
- [Authentication and API keys (EN)](https://docs.durum.ai/en/developers/authentication)

## Plans

- Plan Découverte (EN: Discovery plan) : sans frais, pour toujours, sans carte. Inscription : https://app.durum.ai/login?mode=signup (confirmation par courriel). Limites : 2 000 USD de dépense publicitaire suivie sur 30 jours glissants par espace de travail (toutes régies, converti en USD ; au-delà, 30 jours de tolérance puis passage à un palier payant ; les données continuent d'être enregistrées), 1 connexion CRM, 90 jours d'historique visible, moteur et règles d'ads en simulation seulement, pas d'API ni de serveur MCP (403 plan_free_no_api), pas d'enregistrement d'appels, 50 questions IA et 10 visuels Studio une seule fois, pas de vidéo, rapports marqués « Propulsé par DURUM.ai ».
- Paliers payants (toutes les fonctionnalités) : Starter 197 USD/mois (0 à 9 999 USD de dépense mensuelle, 1 siège recording), Growth 497 USD/mois (10 000 à 49 999, 2 sièges), Scale 997 USD/mois (50 000 à 99 999, 4 sièges), Custom au-delà de 100 000. Siège recording additionnel : 89 USD/mois. Annuel : -20 %.

## Pages clés

- [Plans, facturation et annulation](https://docs.durum.ai/guide/essai-et-facturation)
- [Abonnement et paliers](https://docs.durum.ai/pages/abonnement)
- [API : vue d'ensemble](https://docs.durum.ai/developpeurs/)
- [Authentification et clés](https://docs.durum.ai/developpeurs/authentification)
- [Référence de l'API](https://docs.durum.ai/developpeurs/reference-api)
- [Serveur MCP](https://docs.durum.ai/developpeurs/mcp)
- [Intégrations](https://docs.durum.ai/integrations/vue-ensemble)
- [Plans, Billing and Cancellation (EN)](https://docs.durum.ai/en/guide/trial-and-billing)
- [MCP server (EN)](https://docs.durum.ai/en/developers/mcp)

## Entreprise

- [À propos](https://docs.durum.ai/a-propos) / [About (EN)](https://docs.durum.ai/en/about)
- [Contact](https://docs.durum.ai/contact) / [Contact (EN)](https://docs.durum.ai/en/contact): info@durum.ai
- [Confidentialité](https://docs.durum.ai/confidentialite) / [Privacy (EN)](https://docs.durum.ai/en/privacy)

## Codes d'erreur du plan Découverte

- plan_free_no_api : 403, API REST et MCP réservés aux paliers payants
- plan_free_no_autopilot : exécution réelle des règles et mode Appliquer du moteur réservés aux paliers payants
- plan_free_one_crm : une seule connexion CRM sur le plan Découverte