API Ads · bêta privée

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é

POST /v1/campaigns
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?" }
  }'
201 Created · application/json
{
  "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
L'API

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
Dans la référence

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
Dans la référence

Webhooks

Soyez prévenu à chaque étape : approuvée, refusée, active, en pause, terminée. Envois signés.

  • POST /webhooks
  • campaign.approved
Dans la référence

Créatives

Questions, cosmétiques et habillages de moment, dans les gabarits Echomi, réutilisables d'une campagne à l'autre.

  • POST /creatives
  • GET /formats
Dans la référence
Confidentialité par construction

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.

400 Bad Request
{
  "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

Démarrage

De la bêta à votre première campagne, en trois temps.

  1. 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. 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. 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 :

GET /v1/me
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