Format de réponse

Référence complète pour la structure JSON des réponses, la pagination et les types de données de l'API TCG Price Lookup.

Structure de réponse de base

Toutes les réponses API ont une structure JSON cohérente :

{
  "data": [...],      // tableau d'objets cartes
  "total": 150,       // nombre total de résultats correspondants
  "limit": 20,        // nombre de résultats retournés
  "offset": 0,        // décalage de pagination
  "game": "pokemon"   // contexte du jeu
}

Objet carte

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

États des cartes

Objet carte gradée (forfait Trader ou supérieur)

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

Utilisez les paramètres limit et offset pour les grands ensembles de résultats :

// Première page
const page1 = await tcg.search('charizard', { limit: 20, offset: 0 });

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

// Calculer le nombre total de pages
const totalPages = Math.ceil(page1.total / 20);

Unité des prix

Tous les prix sont des nombres à virgule flottante en dollars américains (USD) :

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