API endpointy

Kompletný referenčný prehľad endpointov TCG Price Lookup API pre vyhľadávanie, detaily kariet, históriu cien, série, hry a hromadné operácie.

Základná URL

https://api.tcgpricelookup.com/v1

Vyhľadávanie kariet podľa názvu naprieč všetkými hrami.

GET /v1/search

Query parametre:

Parameter	Povinný	Popis
`q`	áno	Vyhľadávací dotaz (názov karty)
`game`	nie	Slug hry (napr. `pokemon`, `mtg`, `yugioh`)
`set`	nie	Filtrovanie podľa názvu alebo kódu série
`rarity`	nie	Filtrovanie podľa rarity
`limit`	nie	Počet výsledkov (predvolené: 20, max: 100)
`offset`	nie	Offset pre stránkovanie

Príklad:

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

Získanie podrobných cenových dát pre kartu podľa ID.

GET /v1/cards/:id

Príklad:

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

Získanie histórie cien karty (vyžaduje plán Trader alebo vyšší).

GET /v1/cards/:id/prices

Query parametre:

Parameter	Predvolené	Popis
`days`	30	Počet dní histórie (max: 90)

Zobrazenie všetkých sérií pre konkrétnu hru.

GET /v1/sets?game=pokemon

Získanie až 20 kariet naraz v jednej požiadavke (vyžaduje plán Trader alebo vyšší).

POST /v1/cards/batch

Telo požiadavky:

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