נקודות קצה של ה-API

מדריך מלא לנקודות קצה של חיפוש, פרטי קלף, היסטוריית מחירים, מארזים, משחקים וחיפוש אצווה.

URL בסיס

https://api.tcgpricelookup.com/v1

חפש קלפים בכל המשחקים לפי שם.

GET /v1/search

פרמטרי שאילתה:

פרמטר	נדרש	תיאור
`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

פרמטרי שאילתה:

פרמטר	ברירת מחדל	תיאור
`days`	30	מספר ימי היסטוריה (מקסימום: 90)

הצג את כל המארזים למשחק ספציפי.

GET /v1/sets?game=pokemon

אחזר עד 20 קלפים בבקשה אחת (תוכנית Trader ומעלה).

POST /v1/cards/batch

גוף הבקשה:

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