Endpointy API

Pełny opis endpointów TCG Price Lookup API: wyszukiwanie, szczegóły karty, historia cen, serie, gry i batch.

Bazowy URL

https://api.tcgpricelookup.com/v1

Wyszukuje karty we wszystkich grach według nazwy.

GET /v1/search

Parametry zapytania:

Parametr	Wymagany	Opis
`q`	Tak	Zapytanie wyszukiwania (nazwa karty)
`game`	Nie	Slug gry (np. `pokemon`, `mtg`, `yugioh`)
`set`	Nie	Filtrowanie według nazwy lub kodu serii
`rarity`	Nie	Filtrowanie według rzadkości
`limit`	Nie	Liczba wyników (domyślnie: 20, maks.: 100)
`offset`	Nie	Offset paginacji

Przykład:

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

Pobiera szczegółowe dane cenowe karty według ID.

GET /v1/cards/:id

Przykład:

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

Pobiera historię cen karty (plan Trader lub wyższy).

GET /v1/cards/:id/prices

Parametry zapytania:

Parametr	Domyślnie	Opis
`days`	30	Liczba dni historii (maks.: 90)

Zwraca listę wszystkich serii dla danej gry.

GET /v1/sets?game=pokemon

Pobiera do 20 kart w jednym zapytaniu (plan Trader lub wyższy).

POST /v1/cards/batch

Ciało zapytania:

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