API Эндпоинты

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

Базовый URL

https://api.tcgpricelookup.com/v1

Поиск карт по всем играм по названию.

GET /v1/search

Параметры запроса:

Параметр	Обязательный	Описание
`q`	Да	Поисковый запрос (название карты)
`game`	Нет	Slug игры (напр.: `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"]
}