Endpoint-uri API

Referință completă pentru endpoint-urile de căutare, detalii cărți, istoricul prețurilor, seturi, jocuri și căutare în lot ale TCG Price Lookup API.

URL de bază

https://api.tcgpricelookup.com/v1

Căutați cărți din toate jocurile după nume.

GET /v1/search

Parametri de interogare:

Parametru	Obligatoriu	Descriere
`q`	Da	Interogare de căutare (numele cărții)
`game`	Nu	Slug joc (ex: `pokemon`, `mtg`, `yugioh`)
`set`	Nu	Filtrați după numele sau codul setului
`rarity`	Nu	Filtrați după raritate
`limit`	Nu	Numărul de rezultate (implicit: 20, maxim: 100)
`offset`	Nu	Offset pentru paginare

Exemplu:

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

Obțineți date detaliate de prețuri pentru o carte după ID.

GET /v1/cards/:id

Exemplu:

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

Obțineți istoricul prețurilor pentru o carte (plan Trader sau superior).

GET /v1/cards/:id/prices

Parametri de interogare:

Parametru	Implicit	Descriere
`days`	30	Numărul de zile din istoric (maxim: 90)

Listați toate seturile pentru un joc specific.

GET /v1/sets?game=pokemon

Obțineți până la 20 de cărți într-o singură cerere (plan Trader sau superior).

POST /v1/cards/batch

Corp cerere:

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