Référence API

Documentation

L'API du marché scellé Pokémon FR : prix plancher quotidiens, historique par produit et lien de l'annonce. 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 \ -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 renvoyé (1 produit, 1 jour). Le coût d'un appel suit donc le volume de données renvoyé, pas le nombre de requêtes.

Endpoint	Coût
`/v1/products/{id}/price`	1 crédit
`/v1/products/{id}/history`	1 crédit par point observé
`/v1/products`	1 crédit par produit renvoyé (taille de page)
`/v1/prices`	1 crédit par produit du catalogue

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 le lien de l'annonce.

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

Coût : 1 crédit.

Requête

curl https://api.pokeindex.fr/v1/products/{id}/price \ -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, "currency": "EUR", "source": "vinted", "sourceUrl": "https://vinted.fr/...", "date": "2026-06-10", "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é. 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é (la taille de page).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, "source": "vinted", "date": "2026-06-10" }, // ... 49 autres produits ], "total": 298, "limit": 50, "offset": 0, "next": 50 }

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 ta propre base ou un traitement batch quotidien.

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).
Accès : réservé aux plans 450K et plus, sinon 403 plan_forbidden.

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.
currency	string	Toujours EUR.
source	string	Marketplace du prix plancher : cardmarket, ebay, vinted, leboncoin.
sourceUrl	string	Lien direct vers l'annonce derrière le prix.
date	string	Date du relevé, au format AAAA-MM-JJ.
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