Endpoint API

Riferimento completo per gli endpoint di ricerca, dettaglio carta, storico prezzi, set, giochi e batch di TCG Price Lookup API.

URL base

https://api.tcgpricelookup.com/v1

Cerca carte in tutti i giochi per nome.

GET /v1/search

Parametri query:

Parametro	Obbligatorio	Descrizione
`q`	Sì	Query di ricerca (nome carta)
`game`	No	Slug del gioco (es. `pokemon`, `mtg`, `yugioh`)
`set`	No	Filtra per nome o codice set
`rarity`	No	Filtra per rarità
`limit`	No	Numero di risultati (default: 20, max: 100)
`offset`	No	Offset per la paginazione

Esempio:

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

Recupera dati dettagliati sui prezzi di una carta tramite ID.

GET /v1/cards/:id

Esempio:

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

Recupera lo storico prezzi di una carta (piano Trader o superiore).

GET /v1/cards/:id/prices

Parametri query:

Parametro	Default	Descrizione
`days`	30	Giorni di storico (max: 90)

Elenca tutti i set per un gioco specifico.

GET /v1/sets?game=pokemon

Recupera fino a 20 carte in una sola richiesta (piano Trader o superiore).

POST /v1/cards/batch

Corpo della richiesta:

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