Primeros pasos

Todo lo que necesitas para empezar a usar la API de TCG Price Lookup.

URL base

https://api.tcgpricelookup.com/v1

Obtén tu clave API

Crea una cuenta gratuita para obtener tu clave API. No se requiere tarjeta de crédito.

Añade el header X-API-Key

Incluye tu clave API en el header X-API-Key de cada solicitud.

Haz tu primera solicitud

curl "https://api.tcgpricelookup.com/v1/cards/search?q=charizard&game=pokemon" \
  -H "X-API-Key: YOUR_API_KEY"

Formato de respuesta

Todos los endpoints de listas devuelven un envoltorio consistente con un array data y campos de paginación. Usa los parámetros de consulta limit y offset para paginar los resultados.

{
  "data": [
    {
      "id": "019535a1-d5d0-7c12-a3e8-b7f4c6d8e9a2",
      "name": "Charizard ex",
      "game": "pokemon",
      "set_name": "Obsidian Flames",
      "rarity": "Double Rare",
      "prices": {
        "raw": {
          "near_mint": {
            "tcgplayer": { "market": 48.97 },
            "ebay": { "avg_7d": 50.75 }
          }
        }
      }
    }
  ],
  "total": 47,
  "limit": 20,
  "offset": 0
}

¿Qué sigue?

Autenticación

Configuración de clave API y seguridad

Referencia de API

Documentación interactiva de endpoints

Límites de tasa

Límites, headers y errores

LLM Integration

Grounded retrieval patterns for AI assistants

Realtime Patterns

Polling, backoff, and update stream architecture