Ендпоінти API

Повний довідник ендпоінтів API TCG Price Lookup: пошук, деталі картки, історія цін, набори, ігри та пакетний пошук.

Базова URL

https://api.tcgpricelookup.com/v1

Пошук карток у всіх іграх за назвою.

GET /v1/search

Параметри запиту:

Параметр	Обов’язковий	Опис
`q`	Так	Пошуковий запит (назва картки)
`game`	Ні	Слаг гри (напр.: `pokemon`, `mtg`, `yugioh`)
`set`	Ні	Фільтрація за назвою або кодом набору
`rarity`	Ні	Фільтрація за рідкістю
`limit`	Ні	Кількість результатів (за замовчуванням: 20, макс: 100)
`offset`	Ні	Зміщення для пагінації

Приклад:

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

Отримайте детальні цінові дані для картки за ID.

GET /v1/cards/:id

Приклад:

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

Отримайте історію цін картки (потрібен план Trader або вище).

GET /v1/cards/:id/prices

Параметри запиту:

Параметр	За замовчуванням	Опис
`days`	30	Кількість днів в історії (макс: 90)

Отримайте список усіх наборів для конкретної гри.

GET /v1/sets?game=pokemon

Отримайте до 20 карток одним запитом (потрібен план Trader або вище).

POST /v1/cards/batch

Тіло запиту:

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