Response Format

Kumpletong reference para sa JSON response structure, pagination, at mga uri ng data ng TCG Price Lookup API.

Pangunahing Istraktura ng Response

Lahat ng API response ay may consistent na JSON structure:

{
  "data": [...],      // Array ng card objects
  "total": 150,       // Kabuuang bilang ng matching results
  "limit": 20,        // Bilang ng ibinalik na resulta
  "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"
}

Mga Kondisyon ng Card

Graded Card Object (Trader plan o mas mataas)

{
  "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

Gumamit ng limit at offset parameters para sa malalaking result sets:

// Unang pahina
const page1 = await tcg.search('charizard', { limit: 20, offset: 0 });

// Susunod na pahina
const page2 = await tcg.search('charizard', { limit: 20, offset: 20 });

// Kalkulahin ang kabuuang bilang ng pahina
const totalPages = Math.ceil(page1.total / 20);

Yunit ng Presyo

Lahat ng presyo ay US dollars (USD) na floating point numbers:

"market": 285.00  // $285.00 USD