Amazon PA-API

Vue d'ensemble

Amazon Product Advertising API (PA-API 5.0) est l'API publique d'Amazon permettant d'interroger le catalogue Amazon pour récupérer des données produits : titre, images, prix, avis, ASIN, catégorie, dimensions, etc.

Dans Products Manager, PA-API est utilisée principalement dans deux contextes :

• Module Code2ASIN : résoudre un EAN ou un code produit en ASIN Amazon correspondant, afin de lier chaque fiche produit interne à sa contrepartie Amazon.
• Enrichissement catalogue : récupérer automatiquement les données Amazon (titre enrichi, images haute résolution, prix de référence, nombre d'avis) pour compléter les fiches produits.
• Prix concurrents Amazon : dans le module Price Monitor, PA-API fournit le prix en temps réel du produit sur Amazon pour la marketplace configurée.

PA-API est distincte de SP-API (Selling Partner API) : elle est destinée aux affiliés Amazon Associates et donne accès à la lecture publique du catalogue, sans accès aux données vendeur. Pour les fonctionnalités vendeur (gestion des commandes, inventaire, repricing), voir Amazon SP-API.

Prérequis

Avant de configurer PA-API dans Products Manager, vous devez disposer :

1. Un compte Amazon Associates actif sur la marketplace cible (ex. : amazon.fr pour la France). Le compte doit être approuvé et avoir généré au moins quelques ventes pour bénéficier d'une limite de requêtes suffisante.
2. Des clés PA-API générées depuis le portail Associates :
   • Access Key ID
   • Secret Access Key
   • Partner Tag (aussi appelé tag ou tracking ID, ex. : monsite-21)

Les clés PA-API sont liées à un compte Associates et à une marketplace. Si vous opérez sur plusieurs marketplaces (fr, de, co.uk…), vous aurez besoin d'un compte Associates et d'un jeu de clés par marketplace.

Configuration dans Products Manager

Via l'interface

Rendez-vous dans Settings > AI Providers > Amazon PA-API et renseignez :

Via les variables d'environnement

AMAZON_PA_API_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE
AMAZON_PA_API_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
AMAZON_PA_API_PARTNER_TAG=monsite-21
AMAZON_PA_API_MARKETPLACE=FR

Les variables d'environnement prennent la priorité sur la configuration enregistrée en base. En production, privilégiez les variables d'environnement pour ne pas stocker des secrets en base de données.

Marketplaces supportées

PA-API est disponible sur toutes les principales marketplaces Amazon. Indiquez le code marketplace dans la configuration :

Fonctionnement dans le module Code2ASIN

Le module Code2ASIN utilise PA-API pour résoudre un identifiant produit (EAN, UPC, ISBN) en ASIN Amazon :

1. Le système dispose d'un EAN issu du catalogue fournisseur.
2. Une requête PA-API de type SearchItems est envoyée avec le paramètre Keywords contenant l'EAN, ou via ItemLookup si l'EAN est directement connu.
3. PA-API retourne la liste des ASINs correspondants sur la marketplace configurée.
4. Le premier résultat pertinent (correspondance exacte sur l'EAN ou le code produit) est enregistré dans la table code2asin et associé à la fiche produit.
5. Les données enrichies (titre Amazon, image principale, prix, rating, nombre d'avis) sont optionnellement synchronisées sur la fiche produit.

Ce processus est exécuté en tâche de fond via Celery, en batch ou à la demande depuis l'interface produit (bouton Lookup Amazon).

EAN: 3660895009870
  → PA-API SearchItems (Keywords: "3660895009870", Marketplace: FR)
  → ASIN: B08XYZ1234
  → Titre: "Produit exemple 500ml"
  → Prix: 12.99 EUR
  → Saved to code2asin table

Limites de l'API

PA-API applique des limites de requêtes basées sur l'activité de votre compte Associates :

Important : un compte Associates sans ventes récentes peut voir son accès PA-API révoqué. Amazon requiert une activité commerciale régulière pour maintenir l'accès.

Products Manager applique automatiquement un throttling interne à 1 req/s (configurable via AMAZON_PA_API_RATE_LIMIT) et met en file d'attente les requêtes via Celery pour respecter ces limites.

PA-API vs SP-API

Pour les fonctionnalités SP-API dans Products Manager, voir Amazon SP-API.

Dépannage

Access denied (403)

• Vérifiez que vos clés Access Key et Secret Key sont correctes et actives.
• Vérifiez que le Partner Tag correspond bien à la marketplace configurée (un tag monsite-21 est un tag amazon.fr, pas amazon.de).
• Vérifiez que votre compte Associates est approuvé et actif sur cette marketplace.

InvalidParameterValue

• La marketplace spécifiée ne correspond pas à l'endpoint utilisé. Vérifiez le code marketplace dans la configuration.

TooManyRequests (429) / Throttling

• Vous dépassez la limite de 1 req/s. Products Manager gère ce throttling automatiquement, mais si vous lancez un batch Code2ASIN sur un grand catalogue, prévoyez un délai d'exécution proportionnel.
• Vérifiez que AMAZON_PA_API_RATE_LIMIT n'a pas été augmenté au-delà de ce que votre compte autorise.

Aucun résultat pour un EAN

• Certains produits ne sont pas vendus sur la marketplace cible. Essayez une autre marketplace.
• L'EAN peut être incorrect ou non référencé chez Amazon. Le module Code2ASIN marque ces cas avec le statut NOT_FOUND.