API Epinium

Accès : Configuration → API Keys

Epinium expose vos données via une API REST pour que vous puissiez les lire depuis vos propres outils : un tableau de bord maison, un script d'analyse ou un assistant IA. Ce sont les mêmes informations que celles affichées dans l'application, avec les mêmes chiffres.

Dans sa version actuelle l'API est en lecture seule : elle sert à consulter, pas à modifier des campagnes ou des produits.

Vous voulez l'utiliser depuis un assistant IA ?

Aucun développement n'est nécessaire. Le MCP Epinium connecte ces mêmes données à Claude et à d'autres assistants compatibles.

Générer un token

1. Allez dans Configuration → API Keys
2. Cliquez sur Créer une API key et donnez-lui un nom qui rappelle son usage
3. Cochez les permissions nécessaires
4. Copiez la clé et conservez-la en lieu sûr
5. Utilisez-la dans l'en-tête Authorization de chaque requête

La clé ne s'affiche qu'une seule fois

La valeur complète apparaît une seule fois à la création. Si vous la perdez elle est irrécupérable : il faut la révoquer et en créer une autre.

Permissions

Chaque token porte les permissions cochées à sa création. N'accordez que celles dont votre intégration a besoin.

Permission	Donne accès à
catalog:read	Produits, marques, pays et clusters
campaigns:read	Campagnes, ad groups, targets, product ads et termes de recherche
connections:read	Les connexions Amazon de votre compte
tasks:read	Tâches Epinium et leurs items
skills:read	Le catalogue de playbooks marketing validés d’Epinium

Un token atteint toutes les connexions de votre compte. Si vous êtes une agence, il atteint les connexions que chaque client vous a partagées en acceptant votre invitation.

Quels endpoints elle couvre

Chaque ressource dispose d'un listing, et la plupart permettent aussi de récupérer un élément par son id. Les ressources de métriques n'ont qu'un listing : une ligne agrégée sur une plage de dates n'a pas d'identifiant propre.

Catalogue — catalog:read

Endpoint	Ce qu'il renvoie
/v1/products	Vos produits unifiés
/v1/amazon-seller-products	La vue Seller Central de chaque produit
/v1/amazon-vendor-products	La vue Vendor Central
/v1/amazon-advertising-products	La vue Advertising
/v1/seller-product-metrics	Ventes, sessions, Buy Box et rank par produit
/v1/vendor-product-metrics	Ventes Vendor par produit, avec manufacturing et sourcing
/v1/product-brands	Vos marques
/v1/countries	Pays et marketplaces
/v1/clusters	Vos segmentations de mots-clés

Publicité — campaigns:read

Endpoint	Ce qu'il renvoie
/v1/campaigns	Vos campagnes Amazon Advertising
/v1/campaign-metrics	Dépense, ventes, ACOS et ROAS par campagne
/v1/adgroups	Les ad groups de chaque campagne
/v1/adgroup-metrics	Performance par ad group
/v1/targets	Mots-clés et targets produit
/v1/target-metrics	Performance par target, avec son mot-clé et son type de correspondance
/v1/product-ads	Le lien entre un ad group et le produit qu'il annonce
/v1/product-ad-metrics	Performance par produit annoncé, avec son ASIN
/v1/search-terms	Les recherches réelles des acheteurs
/v1/search-term-metrics	Performance par recherche, avec le texte et le target qui l'a associée

Connexions, tâches et skills

Endpoint	Permission	Ce qu'il renvoie
/v1/connections	connections:read	Vos connexions Amazon
/v1/tasks	tasks:read	Tâches Epinium
/v1/task-items	tasks:read	Les items de chaque tâche
/v1/skills	skills:read	Le catalogue de playbooks marketing d’Epinium

Le catalogue de skills est du contenu rédigé par Epinium, pas des données de votre compte : il est identique pour tous les clients. Les parties de chaque playbook que vous recevez dépendent de votre plan.

Il existe également /v1/me, qui indique quelles permissions et quels comptes votre token atteint. C'est le premier appel utile pour vérifier que la clé fonctionne.

Trois règles pour lire les données

Ces trois points expliquent presque toutes les questions d'interprétation :

• Les montants sont du texte, pas des nombres. "cost": "8.22" arrive en chaîne à dessein, pour ne pas perdre de précision à la conversion en décimal binaire.
• Les ratios sont en fraction, pas en pourcentage. Un ACOS de 90,83 % arrive comme 0.908287. Multipliez par 100 pour l'afficher.
• null n'est pas 0. null signifie qu'Amazon n'a pas remonté la donnée ; 0 signifie un vrai zéro. Un acos à null est une campagne qui a dépensé sans vendre, pas de la publicité gratuite. Et new_to_brand_sales arrive à null en Sponsored Products parce qu'Amazon ne le mesure pas pour ce format.

Limites

• Les métriques exigent une plage de dates. start_date et end_date sont obligatoires sur toutes les ressources de métriques.
• La plage a un maximum, et il dépend de la granularité. Avec granularity=total, 366 jours ; avec granularity=daily, 93. Sur les targets et les termes de recherche, les ressources les plus lourdes, cela descend à 93 et 31. Demander davantage renvoie une erreur indiquant la limite exacte. Les deux dates sont incluses dans la plage.
• Les listings se paginent de deux façons. Les ressources de catalogue et de structure utilisent un curseur (starting_after) ; celles de métriques utilisent limit et offset. Dans les deux cas, has_more indique s'il reste une page.
• Il existe une limite de requêtes par token. Si vous la dépassez vous recevez un 429 et il suffit de réessayer plus lentement.

Paramètres et réponses de chaque endpoint

Le tableau ci-dessus indique quelles ressources existent. Pour voir les paramètres d'entrée et la forme exacte de chaque réponse, il y a deux chemins :

• Référence navigable — chaque endpoint avec ses paramètres, leurs types et un exemple de réponse. Générée depuis l'API elle-même, elle ne peut donc pas devenir obsolète. En anglais.
• Schéma OpenAPI — le document OpenAPI 3.0 brut, à importer dans Postman, Insomnia ou un générateur de clients. Aucun token nécessaire.