API Endpoints

Πλήρης αναφορά για τα endpoints αναζήτησης, λεπτομερειών καρτών, ιστορικού τιμών, σετ, παιχνιδιών και μαζικής αναζήτησης του TCG Price Lookup API.

Βασικό URL

https://api.tcgpricelookup.com/v1

Αναζητήστε κάρτες σε όλα τα παιχνίδια με βάση το όνομα.

GET /v1/search

Query parameters:

Παράμετρος	Απαιτείται	Περιγραφή
`q`	Ναι	Ερώτημα αναζήτησης (όνομα κάρτας)
`game`	Όχι	Slug παιχνιδιού (π.χ. `pokemon`, `mtg`, `yugioh`)
`set`	Όχι	Φιλτράρισμα με βάση το όνομα ή τον κωδικό σετ
`rarity`	Όχι	Φιλτράρισμα με βάση τη σπανιότητα
`limit`	Όχι	Αριθμός αποτελεσμάτων (προεπιλογή: 20, μέγιστο: 100)
`offset`	Όχι	Μετατόπιση για σελιδοποίηση

Παράδειγμα:

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

Ανακτήστε λεπτομερή δεδομένα τιμών για μια κάρτα με βάση το ID.

GET /v1/cards/:id

Παράδειγμα:

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

Ανακτήστε το ιστορικό τιμών μιας κάρτας (απαιτείται πλάνο Trader ή ανώτερο).

GET /v1/cards/:id/prices

Query parameters:

Παράμετρος	Προεπιλογή	Περιγραφή
`days`	30	Αριθμός ημερών ιστορικού (μέγιστο: 90)

Λίστα με όλα τα σετ ενός συγκεκριμένου παιχνιδιού.

GET /v1/sets?game=pokemon

Ανακτήστε έως 20 κάρτες σε 1 αίτημα (απαιτείται πλάνο Trader ή ανώτερο).

POST /v1/cards/batch

Σώμα αιτήματος:

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