รูปแบบ Response

Reference ครบถ้วนสำหรับโครงสร้าง JSON response, pagination และ data type ของ TCG Price Lookup API

โครงสร้าง Response พื้นฐาน

ทุก API response มีโครงสร้าง JSON ที่สอดคล้องกัน:

{
  "data": [...],      // array ของ card object
  "total": 150,       // จำนวนผลลัพธ์ทั้งหมดที่ตรงกัน
  "limit": 20,        // จำนวนผลลัพธ์ที่ return
  "offset": 0,        // pagination offset
  "game": "pokemon"   // game context
}

Card Object

{
  "id": "pokemon-sv4-charizard-ex-006",
  "name": "Charizard ex",
  "game": "pokemon",
  "number": "006",
  "rarity": "Special Illustration Rare",
  "foil": false,
  "set": {
    "id": "sv4",
    "name": "Obsidian Flames",
    "code": "sv4",
    "releaseDate": "2023-08-11",
    "totalCards": 230
  },
  "images": {
    "small": "https://cdn.tcgpricelookup.com/images/pokemon/sv4/006_small.jpg",
    "large": "https://cdn.tcgpricelookup.com/images/pokemon/sv4/006_large.jpg"
  },
  "prices": {
    "nearMint": {
      "market": 285.00,
      "tcgplayer": 280.00,
      "ebay": 290.00,
      "low": 250.00,
      "high": 350.00
    },
    "lightlyPlayed": {
      "market": 240.00,
      "tcgplayer": 235.00,
      "ebay": 245.00
    },
    "moderatelyPlayed": { "market": 200.00 },
    "heavilyPlayed": { "market": 160.00 },
    "damaged": { "market": 100.00 }
  },
  "updatedAt": "2026-04-10T14:32:00Z"
}

สภาพการ์ด

สภาพ	คำอธิบาย
`nearMint`	Near Mint — ไม่มีรอยที่สังเกตเห็นได้
`lightlyPlayed`	Lightly Played — รอยเล็กน้อย
`moderatelyPlayed`	Moderately Played — รอยที่สังเกตเห็นได้
`heavilyPlayed`	Heavily Played — ความเสียหายมาก
`damaged`	Damaged — ความเสียหายรุนแรง

Graded Card Object (แพ็กเกจ Trader ขึ้นไป)

{
  "id": "pokemon-base1-4",
  "graded": {
    "psa": {
      "10": { "market": 12000.00, "population": 128 },
      "9": { "market": 3500.00, "population": 342 },
      "8": { "market": 1200.00 }
    },
    "bgs": {
      "10": { "market": 25000.00 },
      "9.5": { "market": 8000.00 },
      "9": { "market": 4000.00 }
    },
    "cgc": {
      "10": { "market": 5000.00 },
      "9.5": { "market": 2500.00 }
    }
  }
}

Pagination

ใช้ parameter limit และ offset สำหรับผลลัพธ์จำนวนมาก:

// หน้าแรก
const page1 = await tcg.search('charizard', { limit: 20, offset: 0 });

// หน้าถัดไป
const page2 = await tcg.search('charizard', { limit: 20, offset: 20 });

// คำนวณจำนวนหน้าทั้งหมด
const totalPages = Math.ceil(page1.total / 20);

หน่วยราคา

ราคาทั้งหมดเป็น US Dollar (USD) ในรูปแบบ floating point:

"market": 285.00  // $285.00 USD