Endpoints de la API

Referencia completa de los endpoints de búsqueda, detalle de carta, historial de precios, sets, juegos y lote de la API TCG Price Lookup.

URL base

https://api.tcgpricelookup.com/v1

Busca cartas en todos los juegos por nombre.

GET /v1/search

Parámetros de consulta:

Parámetro	Obligatorio	Descripción
`q`	Sí	Consulta de búsqueda (nombre de carta)
`game`	No	Slug del juego (ej: `pokemon`, `mtg`, `yugioh`)
`set`	No	Filtra por nombre o código de set
`rarity`	No	Filtra por rareza
`limit`	No	Número de resultados (por defecto: 20, máx: 100)
`offset`	No	Desplazamiento para paginación

Ejemplo:

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

Obtiene datos de precios detallados de una carta por ID.

GET /v1/cards/:id

Ejemplo:

curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
  -H "X-API-Key: your-api-key"

Obtiene el historial de precios de una carta (plan Trader o superior).

GET /v1/cards/:id/prices

Parámetros de consulta:

Parámetro	Por defecto	Descripción
`days`	30	Número de días de historial (máx: 90)

Lista todos los sets de un juego específico.

GET /v1/sets?game=pokemon

Obtiene hasta 20 cartas en una sola solicitud (plan Trader o superior).

POST /v1/cards/batch

Cuerpo de la solicitud:

{
  "ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}