API-endepunkter
Komplet reference til TCG Price Lookup API's søge-, kortdetalje-, prishistorik-, sæt-, spil- og batch-endepunkter.
Basis-URL
https://api.tcgpricelookup.com/v1
Kortsøgning
Søg efter kort på tværs af alle spil efter navn.
GET /v1/search
Forespørgselsparametre:
| Parameter | Påkrævet | Beskrivelse |
|---|---|---|
q | Ja | Søgeforespørgsel (kortnavn) |
game | Nej | Spil-slug (f.eks. pokemon, mtg, yugioh) |
set | Nej | Filtrer efter sætnavn eller sætkode |
rarity | Nej | Filtrer efter sjældenhed |
limit | Nej | Antal resultater (standard: 20, maks: 100) |
offset | Nej | Offset til paginering |
Eksempel:
curl "https://api.tcgpricelookup.com/v1/search?q=charizard&game=pokemon" \
-H "X-API-Key: your-api-key"
Kortdetaljer
Hent detaljerede prisdata for et kort via ID.
GET /v1/cards/:id
Eksempel:
curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
-H "X-API-Key: your-api-key"
Prishistorik
Hent prishistorik for et kort (kræver Trader-plan eller højere).
GET /v1/cards/:id/prices
Forespørgselsparametre:
| Parameter | Standard | Beskrivelse |
|---|---|---|
days | 30 | Antal dage i historikken (maks: 90) |
Sætliste
List alle sæt for et specifikt spil.
GET /v1/sets?game=pokemon
Batch-søgning
Hent op til 20 kort i én forespørgsel (kræver Trader-plan eller højere).
POST /v1/cards/batch
Request body:
{
"ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}
Understøttede spil-slugs
| Spil | Slug |
|---|---|
| Pokémon TCG (engelsk) | pokemon |
| Pokémon (japansk) | 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 |