Une API publicitaire où cibler l'intime est structurellement impossible.
Pilotez vos campagnes Echomi en REST : ciblage contextuel, revue éditoriale, métriques agrégées. Les données personnelles ne sont pas filtrées — elles ne sont pas là.
Les clés API sont délivrées aux annonceurs de la bêta.
Une question sponsorisée dans le Drop du soir.
Mode test · rien n'est diffusé
curl https://api.echomi.app/v1/campaigns \
-H "Authorization: Bearer echo_test_3c91…" \
-H "Content-Type: application/json" \
-d '{
"name": "Grain Coffee · Morning Drop",
"format": "question",
"billing": "cpe",
"budget": { "amount": 12000, "currency": "EUR" },
"schedule": { "start": "2026-07-01", "end": "2026-07-14" },
"targeting": {
"geo": ["FR", "BE"],
"min_age": 18,
"langs": ["fr"],
"interests": ["coffee", "food_drink"]
},
"creative": { "prompt": "Who deserves a coffee on you today?" }
}'{
"id": "cmp_8K2D",
"name": "Grain Coffee · Morning Drop",
"format": "question",
"billing": "cpe",
"status": "draft",
"budget": { "amount": 12000, "currency": "EUR", "spent": 0 },
"schedule": { "start": "2026-07-01", "end": "2026-07-14" },
"targeting": {
"geo": ["FR", "BE"],
"min_age": 18,
"langs": ["fr"],
"interests": ["coffee", "food_drink"]
},
"creative": { "prompt": "Who deserves a coffee on you today?" },
"editorial_review": { "state": "not_submitted" },
"created_at": "2026-06-08T10:24:00Z"
}- URL de base
- https://api.echomi.app/v1
- Authentification
- Authorization: Bearer echo_live_…
- Format
- REST · JSON · HTTPS
Quatre surfaces, rien de plus.
Tout ce qu'il faut pour lancer, suivre et mesurer une campagne. Rien qui touche aux personnes.
Campagnes
Créez une campagne Moment, Cosmétique ou Question, soumettez-la à la revue, mettez-la en pause, reprenez-la.
- POST /campaigns
- PATCH /campaigns/{id}
- POST /campaigns/{id}/submit
Reporting
Des métriques agrégées par campagne, par jour ou par format. Des totaux, jamais des personnes.
- GET /campaigns/{id}/metrics
- GET /reporting
Webhooks
Soyez prévenu à chaque étape : approuvée, refusée, active, en pause, terminée. Envois signés.
- POST /webhooks
- campaign.approved
Créatives
Questions, cosmétiques et habillages de moment, dans les gabarits Echomi, réutilisables d'une campagne à l'autre.
- POST /creatives
- GET /formats
Ce que l'API ne peut pas faire, même si vous le demandez.
Ce n'est pas une politique qu'on promet de respecter : ces champs n'existent pas dans le schéma.
Ne renvoie jamais
- Le nom, le numéro ou l'identifiant d'un membre.
- Qui a choisi qui, ni ce qui est devenu réciproque.
- Le contenu d'une conversation ou d'une confidence.
- Une réponse individuelle : seulement des totaux.
N'accepte jamais
- Une liste de personnes, de numéros ou d'e-mails à cibler.
- Un ciblage sur les choix, les révélations ou les contacts.
- Un âge minimum sous 18 ans.
- Une diffusion dans une conversation ou au moment de la révélation.
Essayez de cibler une liste de personnes : la requête est refusée avant d'atteindre quoi que ce soit.
{
"error": {
"type": "invalid_request",
"code": "targeting_field_not_allowed",
"param": "targeting.custom_audience",
"message": "Targeting is contextual only: geo, min_age, langs, interests."
}
}Accepté : geo, min_age (≥ 18), langs, intérêts choisis par les membres. Le ciblage en détail
De la bêta à votre première campagne, en trois temps.
- 1
Rejoignez la bêta annonceurs
Dites-nous qui vous êtes et ce que vous voulez construire. La bêta est privée : on ouvre l'accès marque par marque.
Formulaire bêta - 2
Recevez vos clés
Une clé test (echo_test_…) pour construire, une clé live (echo_live_…) pour diffuser. Gardez-les côté serveur.
Authentification - 3
Lancez votre première campagne en mode test
Avec la clé test, créez une campagne et soumettez-la : tout le cycle se déroule, rien n'est diffusé dans l'app.
POST /campaigns
Dès réception, vérifiez votre clé test :
curl https://api.echomi.app/v1/me \
-H "Authorization: Bearer echo_test_3c91…"La réponse indique votre compte annonceur, vos scopes et "key_env": "test".
Construisez une pub qu'on n'a pas envie de bloquer.
Les premiers annonceurs de la bêta façonnent l'API avec nous. Rejoignez-les, nous revenons vers vous avec vos clés.
Une question technique avant de postuler ? sales@echomi.app