Référence API

Documentation

L'API du marché scellé Pokémon FR : prix plancher quotidiens, historique par produit, source et date de relevé. Base : https://api.pokeindex.fr.

Démarrage

1Récupère ta clé API depuis ton tableau de bord.

2Passe-la dans l'en-tête Authorization, en Bearer.

3Appelle un endpoint, reçois du JSON. C'est tout.

curl "https://api.pokeindex.fr/v1/products/etb-chaos-ascendant/price?includeSourceUrl=1" \ -H "Authorization: Bearer sk_live_xxx"

Authentification

Toutes les requêtes passent par HTTPS et exigent ta clé API dans l'en-tête Authorization. Garde ta clé secrète : elle ne doit jamais finir dans un front public.

Authorization

curl https://api.pokeindex.fr/v1/products \ -H "Authorization: Bearer sk_live_xxx"

Crédits & coûts

Tout se facture en crédits. La règle est simple : 1 crédit = 1 prix sans lien d'origine (1 produit, 1 jour). Le coût d'un appel suit le volume de données renvoyé, pas le nombre de requêtes.

Les crédits mesurent le volume. La licence définit le droit d'usage : les packs prépayés couvrent les tests, prototypes, usages personnels, usages internes ou produits gratuits. Un produit commercial ou monétisé nécessite un abonnement actif, à partir du plan 100K, avec mention de Pokéindex comme source des prix affichés.

Endpoint	Coût
`/v1/products/{id}/price`	1 crédit · 3 crédits avec includeSourceUrl=1
`/v1/products/{id}/history`	1 crédit par point observé · 3 crédits par point avec includeSourceUrl=1
`/v1/products`	1 crédit par produit renvoyé · 3 crédits par produit avec includeSourceUrl=1
`/v1/products/{id}/platform-prices`	12 crédits par appel
`/v1/prices`	1 crédit par produit du catalogue · 3 crédits par produit avec includeSourceUrl=1

Chaque réponse renvoie l'en-tête X-Credits-Remaining (solde en direct).
fill=null et fill=ffill n'augmentent pas le coût : on facture les points réellement observés.
Solde épuisé sans overage → 402, et la donnée n'est pas renvoyée (décompte annulé).
Le rate-limit (requêtes/seconde) est séparé et ne consomme pas de crédits.

Prix du jour

GET/v1/products/{id}/price

Renvoie le prix plancher du jour d'un produit, sa source et sa date de relevé. Le lien d'origine est renvoyé avec includeSourceUrl=1.

Paramètre	Type
id	string · requis. L'identifiant du produit.

Coût : 1 crédit, ou 3 crédits avec includeSourceUrl=1.

Requête

curl "https://api.pokeindex.fr/v1/products/{id}/price?includeSourceUrl=1" \ -H "Authorization: Bearer sk_live_xxx"

200 · réponse

{ "id": "etb-chaos-ascendant", "name": "ETB Méga-Évolution Chaos", "type": "ETB", "image": "https://www.pokeindex.fr/ETB/...", "price": 52.00, "retailPrice": 49.99, "currency": "EUR", "source": "vinted", "sourceUrl": "https://vinted.fr/...", "date": "2026-06-10", "releaseDate": "2026-02-20", "history": { "start": "2026-05-22", "points": 19 } }

Historique quotidien

GET/v1/products/{id}/history

La série de prix jour par jour. Les jours sans annonce sont absents (prix observé uniquement).

Paramètre	Type
from	string · date de début (AAAA-MM-JJ).
to	string · date de fin, optionnelle.
fill	string · none (défaut), null ou ffill.

Coût : 1 crédit par point observé, ou 3 crédits par point avec includeSourceUrl=1. La profondeur max dépend de ton plan (7j, 90j, illimité).

Requête

curl "https://api.pokeindex.fr/v1/products/{id}/history?from=2026-05-22" \ -H "Authorization: Bearer sk_live_xxx"

200 · réponse

{ "id": "etb-chaos-ascendant", "currency": "EUR", "history": { "start": "2026-05-22", "points": 19 }, "prices": [ { "date": "2026-06-10", "price": 52.00, "source": "vinted" }, { "date": "2026-06-09", "price": 53.50, "source": "ebay" } ] }

Catalogue produits

GET/v1/products

Le catalogue paginé : chaque produit avec son prix du jour, son visuel et les métadonnées d'historique. C'est l'endpoint pour découvrir les id disponibles.

Paramètre	Type
limit	integer · taille de page. Défaut 50, max 200.
offset	integer · décalage de pagination. Défaut 0.
type	string · filtre par type de produit (ETB, Display, Coffret...).

Coût : 1 crédit par produit renvoyé, ou 3 crédits par produit avec includeSourceUrl=1.next donne l'offset de la page suivante, ou null à la fin.

Requête

curl "https://api.pokeindex.fr/v1/products?limit=50&type=ETB" \ -H "Authorization: Bearer sk_live_xxx"

200 · réponse

{ "data": [ { "id": "etb-eclipse-cosmique", "name": "ETB Éclipse Cosmique", "type": "ETB", "image": "https://www.pokeindex.fr/ETB/...", "price": 52.00, "retailPrice": 49.99, "source": "vinted", "date": "2026-06-10", "releaseDate": "2019-11-01" }, // ... 49 autres produits ], "total": 298, "limit": 50, "offset": 0, "next": 50 }

Prix par plateforme

GET/v1/products/{id}/platform-prices

Les quatre prix plancher du dernier relevé côte à côte (Vinted, Leboncoin, eBay, Cardmarket) plus le average : la moyenne des plateformes réellement disponibles. L'endpoint le plus riche de l'API, pensé pour les intégrations B2B avancées.

Paramètre	Type
id	string · requis. L'identifiant du produit.

Coût : 12 crédits par appel. Une plateforme sans offre disponible renvoie price: null et available: false, et n'entre pas dans le calcul de la moyenne.

Requête

curl https://api.pokeindex.fr/v1/products/{id}/platform-prices \ -H "Authorization: Bearer sk_live_xxx"

200 · réponse

{ "id": "etb-eclipse-cosmique", "date": "2026-06-15", "average": 51.20, "currency": "EUR", "platforms": { "vinted": { "price": 48.00, "sourceUrl": "...", "available": true }, "leboncoin": { "price": 52.00, "sourceUrl": "...", "available": true }, "ebay": { "price": 53.50, "sourceUrl": "...", "available": true }, "cardmarket": { "price": null, "sourceUrl": null, "available": false } } }

Export bulk

GET/v1/prices

Le snapshot complet du jour en un seul appel : tous les produits du catalogue avec leur prix. Pensé pour alimenter un cache serveur ou un traitement batch quotidien dans le cadre d'une licence active.

Paramètre	Type
Aucun paramètre : l'appel renvoie tout le catalogue du jour.

Coût : 1 crédit par produit du catalogue (~300 crédits par appel), ou 3 crédits par produit avec includeSourceUrl=1.
Accès : réservé aux plans 450K et plus, sinon 403 plan_forbidden. La redistribution brute du dataset ou la mise à disposition d'un accès équivalent à l'API restent interdites.

Requête

curl https://api.pokeindex.fr/v1/prices \ -H "Authorization: Bearer sk_live_xxx"

200 · réponse

{ "count": 298, "currency": "EUR", "data": [ { "id": "etb-chaos-ascendant", "price": 52.00, /* ... */ }, // ... le catalogue complet du jour ] }

À venir

GET

/v1/index/isp-fr

Indice ISP-FR du marché scellé FR : un chiffre quotidien pour suivre le marché entier.

Bientôt

L'objet Produit

Champ	Type	Description
id	string	Identifiant unique du produit.
name	string	Nom complet du produit, préfixé par son type commercial (ex : ETB Éclipse Cosmique).
type	string	ETB, Display, Bundle, Coffret, Pokébox...
image	string	URL du visuel du produit, servie par le CDN Pokéindex. Peut être null.
price	number	Prix plancher du jour, en euros.
retailPrice	number	Prix retail conseillé à la sortie, en euros. Peut être null si inconnu.
currency	string	Toujours EUR.
source	string	Marketplace du prix plancher : cardmarket, ebay, vinted, leboncoin.
sourceUrl	string	Lien d'origine lorsqu'il est disponible. Renvoyé uniquement avec includeSourceUrl=1 sur les endpoints compatibles. Ce lien reste soumis aux conditions des plateformes tierces.
date	string	Date du relevé, au format AAAA-MM-JJ.
releaseDate	string	Date de sortie officielle du produit, au format AAAA-MM-JJ. Peut être null si inconnue.
history.start	string	Date du premier relevé disponible pour ce produit.
history.points	integer	Nombre de relevés quotidiens disponibles.

Erreurs & limites

Codes HTTP standards, erreurs au format { "error": { "code", "message" } }. Chaque réponse renvoie X-Credits-Remaining (solde de crédits) et les en-têtes de rate-limit.

Code	Erreur	Description
401	invalid_key	Clé API absente ou invalide.
402	insufficient_credits	Crédits épuisés (et pas d'overage). La donnée n'est pas renvoyée.
403	plan_forbidden	Endpoint non inclus dans ton plan (ex : bulk sur un petit plan).
404	not_found	Produit introuvable.
429	rate_limited	Trop de requêtes par seconde (rate-limit).
5xx	server_error	Erreur côté serveur, réessaie un peu plus tard.

PRÊT ?

Ta première requête est à 2 minutes.

Génère ta clé depuis la console, recharge des crédits et appelle l'API.

Ouvrir la console