API Endpoints

Reference ครบถ้วนสำหรับ endpoint ค้นหา รายละเอียดการ์ด ประวัติราคา ชุด เกม และ batch ของ TCG Price Lookup API

Base URL

https://api.tcgpricelookup.com/v1

ค้นหาการ์ดทุกเกมด้วยชื่อ

GET /v1/search

Query Parameters:

Parameter	จำเป็น	คำอธิบาย
`q`	ใช่	search query (ชื่อการ์ด)
`game`	ไม่	game slug เช่น `pokemon`, `mtg`, `yugioh`
`set`	ไม่	filter ตามชื่อหรือ code ชุด
`rarity`	ไม่	filter ตาม rarity
`limit`	ไม่	จำนวนผลลัพธ์ (default: 20, max: 100)
`offset`	ไม่	offset สำหรับ pagination

ตัวอย่าง:

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:

Parameter	Default	คำอธิบาย
`days`	30	จำนวนวันย้อนหลัง (max: 90)

แสดงชุดทั้งหมดของเกมที่ระบุ

GET /v1/sets?game=pokemon

ดึงข้อมูลการ์ดสูงสุด 20 ใบใน 1 request (ต้องการแพ็กเกจ Trader ขึ้นไป)

POST /v1/cards/batch

Request Body:

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