Comenzar

Cómo empezar a usar la API TCG Price Lookup en menos de 5 minutos.

1. Obtenga su clave de API

Regístrese en tcgpricelookup.com y obtenga su clave de API gratuita desde el panel de control. El plan gratuito incluye 200 solicitudes por día y no requiere tarjeta de crédito.

Tras iniciar sesión, navegue a la sección Dashboard → API Keys. Su clave tendrá este formato:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Mantenga esta clave en secreto. No la confirme en el control de versiones ni la exponga en código del lado del cliente.

2. Instale el SDK

Elija su lenguaje preferido e instale el SDK oficial:

# 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

Todos los SDK gestionan automáticamente la autenticación, la serialización de solicitudes, el análisis de errores y los encabezados de límite de tasa.

3. Envíe su primera solicitud

Aquí hay ejemplos mínimos en cada lenguaje compatible:

// 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 de objetos de carta con precios de mercado en vivo
# 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. Revise la respuesta

Una respuesta exitosa tiene esta estructura:

{
  "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. Próximos pasos