Données produits & prix par EAN et ASIN
Une API REST commerciale : envoyez un EAN/GTIN ou un ASIN et recevez le produit ainsi que les prix actuels de toutes les boutiques, des statistiques de prix et la disponibilité. Idéale pour les sites comparateurs, les applications, le repricing et les agents IA.
Pour les agents IA & LLM : spécification lisible par machine sur /api/v1/openapi.json (OpenAPI 3.1) et un aperçu sur /llms.txt. Auth : en-tête x-api-key. Endpoint principal : GET /api/v1/lookup?ean=|asin=.
Plans
Chaque requête authentifiée est décomptée de votre quota mensuel. En cas de dépassement, l'API répond par un 402.
Authentification
Envoyez votre clé dans l'en-tête x-api-key. Chaque réponse contient X-Plan, X-Quota-Limit et X-Quota-Remaining.
Lookup par EAN / ASIN
L'endpoint principal — les données de prix pour un identifiant.
Requête
curl -H "x-api-key: YOUR_KEY" \ "https://api.nidprix.fr/api/v1/lookup?ean=4006381333931"
Réponse
{
"data": {
"identifier": { "ean": "4006381333931", "asin": "B0...", "mpn": "..." },
"product": { "name": "...", "brand": "...", "url": "..." },
"priceStats": { "currency": "EUR", "min": 1299.0, "max": 1499.0,
"lowestEver": 1249.0, "offerCount": 6 },
"offers": [
{ "merchant": "MediaMarkt", "totalPrice": 1299.0,
"availability": "in_stock", "url": ".../go/123" }
]
}
}Endpoints
| Méthode | Chemin | Description | Auth |
|---|---|---|---|
| GET | /api/v1/lookup?ean= | asin= | ★ Produit + tous les prix des boutiques par EAN/GTIN ou ASIN | Clé API |
| GET | /api/v1/products?q=&category=&brand=&sort= | Rechercher & filtrer des produits | Clé API |
| GET | /api/v1/products/{slug} | Détail produit avec offres | Clé API |
| GET | /api/v1/products/{id}/offers | Toutes les offres d'un produit | Clé API |
| GET | /api/v1/products/{id}/price-history?days=90 | Historique des prix | Clé API |
| GET | /api/v1/categories · /brands · /merchants | Données de référence | Clé API |
| GET | /api/v1/articles | Articles de guides | Clé API |
| GET | /api/v1/plans · /openapi.json | Plans & spécification OpenAPI (public) | public |
Codes de statut
| 401 | Clé API absente ou invalide (en-tête x-api-key). |
| 402 | Quota mensuel épuisé — passez à un plan supérieur. |
| 404 | Aucun produit trouvé pour cet EAN/ASIN. |
| 429 | Limite de débit dépassée (requêtes par minute). |
Questions fréquentes
- Comment obtenir les prix des produits par EAN ou ASIN ?
- Envoyez GET /api/v1/lookup?ean=<EAN> ou ?asin=<ASIN> avec votre clé API dans l'en-tête x-api-key. La réponse contient le produit, des statistiques de prix et toutes les offres des boutiques avec le prix total.
- Combien coûte la Product Data API de Nidprix ?
- Il existe un plan Free gratuit avec 100 requêtes/mois ainsi que Starter (29 €, 10 000), Pro (99 €, 100 000) et Enterprise (illimité, sur demande).
- Comment l'utilisation est-elle facturée ?
- Chaque requête authentifiée est décomptée de votre quota mensuel. Le compteur est réinitialisé au début de chaque mois calendaire. En cas de dépassement, l'API répond par un HTTP 402.
- Existe-t-il une spécification lisible par machine ?
- Oui, une spécification OpenAPI 3.1 sur /api/v1/openapi.json et un aperçu adapté aux LLM sur /llms.txt.