API végpontok
A TCG Price Lookup API keresési, kártyarészlet, ártörténet, készlet, játék és kötegelt keresési végpontjainak teljes referenciája.
Alap URL
https://api.tcgpricelookup.com/v1
Kártyakeresés
Kártyák keresése névvel az összes játékban.
GET /v1/search
Query paraméterek:
| Paraméter | Kötelező | Leírás |
|---|---|---|
q | Igen | Keresési lekérdezés (kártyanév) |
game | Nem | Játék slug (pl. pokemon, mtg, yugioh) |
set | Nem | Szűrés készletnév vagy készletkód alapján |
rarity | Nem | Szűrés ritkaság alapján |
limit | Nem | Eredmények száma (alapértelmezett: 20, max: 100) |
offset | Nem | Lapozáshoz szükséges eltolás |
Példa:
curl "https://api.tcgpricelookup.com/v1/search?q=charizard&game=pokemon" \
-H "X-API-Key: your-api-key"
Kártya részletei
Kártya részletes ár adatainak lekérése azonosító alapján.
GET /v1/cards/:id
Példa:
curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
-H "X-API-Key: your-api-key"
Ártörténet
Kártya ártörténetének lekérése (Trader csomag vagy magasabb szükséges).
GET /v1/cards/:id/prices
Query paraméterek:
| Paraméter | Alapértelmezett | Leírás |
|---|---|---|
days | 30 | Előzmény napok száma (max: 90) |
Készletek listája
Egy adott játék összes készletének felsorolása.
GET /v1/sets?game=pokemon
Kötegelt keresés
Legfeljebb 20 kártya lekérése egyetlen kéréssel (Trader csomag vagy magasabb szükséges).
POST /v1/cards/batch
Kérés törzse:
{
"ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}
Támogatott játék slugok
| Játék | Slug |
|---|---|
| Pokémon TCG (angol) | pokemon |
| Pokémon (japán) | pokemonjp |
| Magic: The Gathering | mtg |
| Yu-Gi-Oh! | yugioh |
| Disney Lorcana | lorcana |
| One Piece kártyajáték | onepiece |
| Star Wars: Unlimited | swu |
| Flesh and Blood | fab |