API Endpoints

Vollständige Referenz für die TCG Price Lookup API — Suche, Kartendetails, Preisverlauf, Sets, Spiele und Batch-Suche.

Basis-URL

https://api.tcgpricelookup.com/v1

Karten über alle Spiele hinweg nach Namen suchen.

GET /v1/search

Query-Parameter:

Parameter	Pflicht	Beschreibung
`q`	Ja	Suchanfrage (Kartenname)
`game`	Nein	Spiel-Slug (z.B. `pokemon`, `mtg`, `yugioh`)
`set`	Nein	Nach Set-Name oder Set-Code filtern
`rarity`	Nein	Nach Seltenheit filtern
`limit`	Nein	Anzahl Ergebnisse (Standard: 20, Max: 100)
`offset`	Nein	Paginierungs-Offset

Beispiel:

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

Detaillierte Preisdaten für eine Karte per ID abrufen.

GET /v1/cards/:id

Beispiel:

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

Preisverlauf einer Karte abrufen (Trader-Plan oder höher erforderlich).

GET /v1/cards/:id/prices

Query-Parameter:

Parameter	Standard	Beschreibung
`days`	30	Anzahl Verlaufstage (Max: 90)

Alle Sets für ein bestimmtes Spiel auflisten.

GET /v1/sets?game=pokemon

Bis zu 20 Karten in einer Anfrage abrufen (Trader-Plan oder höher erforderlich).

POST /v1/cards/batch

Request-Body:

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