Démarrage rapide

Comment commencer à utiliser l'API TCG Price Lookup en moins de 5 minutes.

1. Obtenez votre clé API

Inscrivez-vous sur tcgpricelookup.com et récupérez votre clé API gratuite depuis le tableau de bord. Le forfait gratuit inclut 200 requêtes par jour, aucune carte de crédit requise.

Après connexion, rendez-vous dans la section Tableau de bord → Clés API. Votre clé ressemble à ceci :

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Gardez cette clé secrète. Ne la committez pas dans un système de contrôle de version et ne l’exposez pas dans du code côté client.

2. Installez un SDK

Choisissez votre langage préféré et installez le SDK officiel :

# JavaScript / TypeScript
npm install tcglookup

# Python
pip install tcglookup

# Go
go get github.com/TCG-Price-Lookup/tcglookup-go

# Rust
cargo add tcglookup

# PHP
composer require tcg-price-lookup/tcglookup

Tous les SDK gèrent automatiquement l’authentification, la sérialisation des requêtes, le parsing des erreurs et les en-têtes de limite de débit.

3. Envoyez votre première requête

Voici un exemple minimal dans chaque langage pris en charge :

// JavaScript / TypeScript
import { TCGLookup } from 'tcglookup';

const tcg = new TCGLookup({ apiKey: 'your-api-key' });

const results = await tcg.search('charizard', { game: 'pokemon', limit: 5 });
console.log(results.data);
// → tableau d'objets cartes avec les prix du marché en direct
# Python
from tcglookup import TCGLookup

tcg = TCGLookup(api_key='your-api-key')
results = tcg.search('charizard', game='pokemon', limit=5)
print(results.data)
// Go
client := tcglookup.NewClient("your-api-key")
results, _ := client.Search("charizard", &tcglookup.SearchParams{Game: "pokemon"})

4. Examinez la réponse

Une réponse réussie a la structure suivante :

{
  "data": [
    {
      "id": "pokemon-base1-4",
      "name": "Charizard",
      "game": "pokemon",
      "set": { "name": "Base Set", "code": "base1" },
      "rarity": "Rare Holo",
      "prices": {
        "nearMint": {
          "market": 450.00,
          "tcgplayer": 445.00,
          "ebay": 455.00
        },
        "lightlyPlayed": {
          "market": 380.00
        }
      }
    }
  ],
  "total": 12,
  "limit": 5,
  "offset": 0
}

5. Prochaines étapes