Référence de l’API publique (REST, /v1)

L’API publique de Traqio est une API REST versionnée, sous /v1, qui expose les mêmes rapports que la console : ROAS par campagne, ensemble de publicités et publicité, ROAS quotidien, cohortes d’installations, revenus, données refusées, état des connecteurs et liens de tracking. Les mêmes opérations sont disponibles comme outils pour Claude, Cursor et d’autres clients MCP via le serveur MCP. Les deux s’authentifient avec une seule clé API à scopes.

Authentification#

Créez une clé dans la console sous Paramètres → Clés d’API, cochez ses scopes, et envoyez-la comme jeton bearer. Les clés commencent par tq_live_ et ne sont affichées qu’une fois — Traqio ne stocke qu’un hachage et le préfixe visible de la clé. Un jeton de connexion à la console est refusé par l’API, et une clé API est refusée par la console.

export TRAQIO_API_KEY=tq_live_…

# 1. Which apps do I have? Every report takes a productId.
curl -s "https://api.traqio.app/v1/products" -H "Authorization: Bearer $TRAQIO_API_KEY"

# 2. Which ads made money in September? (`to` is exclusive)
curl -s -G "https://api.traqio.app/v1/reports/roas" -H "Authorization: Bearer $TRAQIO_API_KEY" \
  -d productId=app_… -d from=2026-09-01 -d to=2026-10-01 -d level=ad

# 3. Is the spend pull healthy, or is every ROAS stale?
curl -s "https://api.traqio.app/v1/reports/connectors" -H "Authorization: Bearer $TRAQIO_API_KEY"

Scopes#

Aucun scope n’en implique un autre — links:write n’accorde pas links:read — et une clé ne peut jamais faire plus que ce que permet le rôle du membre qui l’a créée. La révocation d’une clé prend effet à son appel suivant.

Endpoints#

La référence complète, lisible par machine, est accessible sans authentification à https://api.traqio.app/v1/openapi.json (OpenAPI 3.1). Elle est générée à partir de la même description que celle contre laquelle les routes sont testées : elle ne peut donc pas décrire un endpoint qui n’existe pas.

Conventions#

• Les dates sont au format YYYY-MM-DD en UTC. from est inclus et to est exclu : from=2026-09-01&to=2026-10-01 correspond à septembre.
• Les routes de rapport prennent productId, from et to ; store=ios|android est optionnel, et les deux stores sont combinés sans lui.
• L’argent n’est jamais additionné entre devises : chaque devise a sa propre ligne, et les dépenses sont dans la devise de facturation de chaque compte publicitaire.
• POST /v1/reports/sync-spend peut être appelé deux fois sans risque : un jour est écrasé, jamais doublé — c’est aussi ainsi que les corrections d’un réseau sur ses dépenses récentes sont intégrées.

Créer un lien de tracking#

curl -s -X POST "https://api.traqio.app/v1/links" \
  -H "Authorization: Bearer $TRAQIO_API_KEY" -H "content-type: application/json" \
  -d '{
    "productId": "app_…",
    "label": "Meta / autumn / video B",
    "network": "meta",
    "campaignExtId": "1203…",
    "code": "autumn-b",
    "deepLink": "/offers/autumn"
  }'

Voir Liens de tracking pour ce que fait chaque champ une fois le lien en ligne.

Erreurs#

Les erreurs sont en JSON, avec un message lisible par un humain.

Questions fréquentes#

L’API est-elle incluse dans chaque offre ?

Oui. L’API et le serveur MCP ne dépendent pas de l’offre : chaque compte peut créer des clés API.

Une clé API peut-elle créer d’autres clés ou modifier la facturation ?

Non. Une clé lit les rapports et, avec les scopes d’écriture correspondants, déclenche une récupération des dépenses, crée des liens de tracking ou efface les données d’un utilisateur sur demande. Gérer les clés, les identifiants, les membres ou la facturation demande toujours une personne connectée.

Que devient une clé quand la personne qui l’a créée quitte l’équipe ?

Rien : une clé appartient à l’espace de travail, pas à la personne qui l’a créée, si bien qu’une intégration ne casse pas à son départ. Révoquez depuis la console les clés dont vous ne voulez plus ; chacune indique sa dernière utilisation, et une clé révoquée est refusée dès son appel suivant.

L’API va-t-elle changer sous mon intégration ?

Pas au sein de /v1. Les changements additifs — un nouvel endpoint, un nouveau champ dans une réponse — ont lieu dans /v1 ; tout ce qui pourrait casser une intégration qui fonctionne passe en /v2, et /v1 continue de répondre.