Endpoints da API

Referência completa dos endpoints de busca, detalhes de cartas, histórico de preços, conjuntos, jogos e batch da TCG Price Lookup API.

URL base

https://api.tcgpricelookup.com/v1

Busca cartas em todos os jogos pelo nome.

GET /v1/search

Parâmetros de query:

Parâmetro	Obrigatório	Descrição
`q`	Sim	Query de busca (nome da carta)
`game`	Não	Slug do jogo (ex: `pokemon`, `mtg`, `yugioh`)
`set`	Não	Filtra por nome ou código do conjunto
`rarity`	Não	Filtra por raridade
`limit`	Não	Número de resultados (padrão: 20, máximo: 100)
`offset`	Não	Offset para paginação

Exemplo:

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

Obtém dados detalhados de preços de uma carta pelo ID.

GET /v1/cards/:id

Exemplo:

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

Obtém o histórico de preços de uma carta (plano Trader ou superior).

GET /v1/cards/:id/prices

Parâmetros de query:

Parâmetro	Padrão	Descrição
`days`	30	Número de dias de histórico (máximo: 90)

Lista todos os conjuntos de um jogo específico.

GET /v1/sets?game=pokemon

Obtém até 20 cartas em uma única requisição (plano Trader ou superior).

POST /v1/cards/batch

Corpo da requisição:

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