Endpoints API

Référence complète pour les endpoints de recherche, détails de cartes, historique des prix, sets, jeux et recherche en lot de l'API TCG Price Lookup.

URL de base

https://api.tcgpricelookup.com/v1

Recherchez des cartes dans tous les jeux par nom.

GET /v1/search

Paramètres de requête :

Paramètre	Requis	Description
`q`	Oui	Terme de recherche (nom de carte)
`game`	Non	Slug du jeu (ex : `pokemon`, `mtg`, `yugioh`)
`set`	Non	Filtrer par nom ou code de set
`rarity`	Non	Filtrer par rareté
`limit`	Non	Nombre de résultats (défaut : 20, max : 100)
`offset`	Non	Décalage pour la pagination

Exemple :

curl "https://api.tcgpricelookup.com/v1/search?q=charizard&game=pokemon" \
  -H "X-API-Key: your-api-key"

Récupérez les données de prix détaillées d’une carte par son ID.

GET /v1/cards/:id

Exemple :

curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
  -H "X-API-Key: your-api-key"

Récupérez l’historique des prix d’une carte (forfait Trader ou supérieur).

GET /v1/cards/:id/prices

Paramètres de requête :

Paramètre	Défaut	Description
`days`	30	Nombre de jours d’historique (max : 90)

Listez tous les sets d’un jeu spécifique.

GET /v1/sets?game=pokemon

Récupérez jusqu’à 20 cartes en une seule requête (forfait Trader ou supérieur).

POST /v1/cards/batch

Corps de la requête :

{
  "ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}