API-päätepisteet
Täydellinen viite TCG Price Lookup API:n haku-, korttitiedot-, hintahistoria-, setti-, peli- ja erähaupäätepisteille.
Perus-URL
https://api.tcgpricelookup.com/v1
Korttihaku
Hae kortteja nimellä kaikista peleistä.
GET /v1/search
Kyselyparametrit:
| Parametri | Pakollinen | Kuvaus |
|---|---|---|
q | Kyllä | Hakukysely (kortin nimi) |
game | Ei | Pelijälki (esim. pokemon, mtg, yugioh) |
set | Ei | Suodata setin nimellä tai koodilla |
rarity | Ei | Suodata harvinaisuudella |
limit | Ei | Tulosten määrä (oletus: 20, max: 100) |
offset | Ei | Sivutuksen offset |
Esimerkki:
curl "https://api.tcgpricelookup.com/v1/search?q=charizard&game=pokemon" \
-H "X-API-Key: your-api-key"
Kortin tiedot
Hae kortin yksityiskohtaiset hintatiedot ID:llä.
GET /v1/cards/:id
Esimerkki:
curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
-H "X-API-Key: your-api-key"
Hintahistoria
Hae kortin hintahistoria (Trader-taso tai korkeampi).
GET /v1/cards/:id/prices
Kyselyparametrit:
| Parametri | Oletus | Kuvaus |
|---|---|---|
days | 30 | Historian päivien määrä (max: 90) |
Settilista
Listaa kaikki setin tietyn pelin setit.
GET /v1/sets?game=pokemon
Erähaku
Hae jopa 20 korttia yhdellä pyynnöllä (Trader-taso tai korkeampi).
POST /v1/cards/batch
Pyyntörunko:
{
"ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}
Tuetut pelijäljet
| Peli | Jälki |
|---|---|
| Pokémon TCG (englanti) | pokemon |
| Pokémon (japani) | pokemonjp |
| Magic: The Gathering | mtg |
| Yu-Gi-Oh! | yugioh |
| Disney Lorcana | lorcana |
| One Piece Card Game | onepiece |
| Star Wars: Unlimited | swu |
| Flesh and Blood | fab |