Erste Schritte

So beginnen Sie in unter 5 Minuten mit der TCG Price Lookup API.

1. API-Schlüssel erhalten

Registrieren Sie sich auf tcgpricelookup.com und erhalten Sie Ihren kostenlosen API-Schlüssel über das Dashboard. Der Free-Plan enthält 200 Anfragen pro Tag — keine Kreditkarte erforderlich.

Nach dem Einloggen navigieren Sie zu Dashboard → API-Schlüssel. Ihr Schlüssel hat folgendes Format:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Halten Sie diesen Schlüssel geheim. Commiten Sie ihn nicht in die Versionsverwaltung und exponieren Sie ihn nicht in clientseitigem Code.

2. SDK installieren

Wählen Sie Ihre bevorzugte Sprache und installieren Sie das offizielle SDK:

# 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

Alle SDKs übernehmen automatisch Authentifizierung, Request-Serialisierung, Fehleranalyse und Rate-Limit-Header.

3. Erste Anfrage senden

Minimalbeispiele in jeder unterstützten Sprache:

// 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);
// → Array von Kartenobjekten mit Live-Marktpreisen
# 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. Antwort prüfen

Eine erfolgreiche Antwort hat folgende Struktur:

{
  "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. Nächste Schritte