Μορφή Αποκρίσεων

Πλήρης αναφορά για τη δομή JSON αποκρίσεων, τη σελιδοποίηση και τους τύπους δεδομένων του TCG Price Lookup API.

Βασική δομή απόκρισης

Όλες οι αποκρίσεις API έχουν συνεπή δομή JSON:

{
  "data": [...],      // Πίνακας αντικειμένων καρτών
  "total": 150,       // Συνολικός αριθμός αποτελεσμάτων που ταιριάζουν
  "limit": 20,        // Αριθμός αποτελεσμάτων που επιστράφηκαν
  "offset": 0,        // Μετατόπιση σελιδοποίησης
  "game": "pokemon"   // Πλαίσιο παιχνιδιού
}

Αντικείμενο κάρτας

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

Καταστάσεις καρτών

Αντικείμενο βαθμολογημένης κάρτας (πλάνο 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 }
    }
  }
}

Σελιδοποίηση

Χρησιμοποιήστε τις παραμέτρους 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);

Μονάδες τιμών

Όλες οι τιμές είναι αριθμοί κινητής υποδιαστολής σε δολάρια ΗΠΑ (USD):

"market": 285.00  // $285,00 USD