API endpointy

Kompletní reference endpointů TCG Price Lookup API pro vyhledávání, detail karty, historii cen, sady, hry a hromadné dotazy.

Základní URL

https://api.tcgpricelookup.com/v1

Vyhledávejte karty ze všech her podle názvu.

GET /v1/search

Query parametry:

Parametr	Povinný	Popis
`q`	Ano	Vyhledávací dotaz (název karty)
`game`	Ne	Slug hry (např. `pokemon`, `mtg`, `yugioh`)
`set`	Ne	Filtrování podle názvu nebo kódu sady
`rarity`	Ne	Filtrování podle rarity
`limit`	Ne	Počet výsledků (výchozí: 20, max: 100)
`offset`	Ne	Offset pro stránkování

Příklad:

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

Získejte podrobná cenová data karty podle ID.

GET /v1/cards/:id

Příklad:

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

Získejte historii cen karty (vyžaduje plán Trader nebo vyšší).

GET /v1/cards/:id/prices

Query parametry:

Parametr	Výchozí	Popis
`days`	30	Počet dní historie (max: 90)

Vypište všechny sady pro konkrétní hru.

GET /v1/sets?game=pokemon

Získejte až 20 karet v jednom požadavku (vyžaduje plán Trader nebo vyšší).

POST /v1/cards/batch

Tělo požadavku:

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