Endpoint API

Tài liệu tham khảo đầy đủ cho tìm kiếm, chi tiết thẻ, lịch sử giá, bộ bài, trò chơi và batch của TCG Price Lookup API.

URL cơ sở

https://api.tcgpricelookup.com/v1

Tìm kiếm thẻ trong tất cả trò chơi theo tên.

GET /v1/search

Tham số query:

Tham số	Bắt buộc	Mô tả
`q`	Có	Query tìm kiếm (tên thẻ)
`game`	Không	Slug trò chơi (ví dụ: `pokemon`, `mtg`, `yugioh`)
`set`	Không	Lọc theo tên hoặc mã bộ bài
`rarity`	Không	Lọc theo độ hiếm
`limit`	Không	Số kết quả (mặc định: 20, tối đa: 100)
`offset`	Không	Offset cho phân trang

Ví dụ:

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

Lấy dữ liệu giá chi tiết cho một thẻ theo ID.

GET /v1/cards/:id

Ví dụ:

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

Lấy lịch sử giá của thẻ (yêu cầu gói Trader trở lên).

GET /v1/cards/:id/prices

Tham số query:

Tham số	Mặc định	Mô tả
`days`	30	Số ngày lịch sử (tối đa: 90)

Liệt kê tất cả bộ bài cho một trò chơi cụ thể.

GET /v1/sets?game=pokemon

Lấy tối đa 20 thẻ trong một yêu cầu (yêu cầu gói Trader trở lên).

POST /v1/cards/batch

Request body:

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