$ curl https://api.tcgpricelookup.com/v1/search

Самый быстрый
TCG Price API
для разработчиков

API цен на карточки в реальном времени для Pokemon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece и ещё 3 игр. Более 300 000 карточек, 5 официальных SDK, бесплатный тариф включён.

300,000+ Карточек
8 Игр
5 SDK
2 Рынков
Free Бесплатный тариф
24/7 Обновления
Быстрый старт JavaScript
// Search for any card across all 8 games
import { TCGLookup } from 'tcglookup';

const tcg = new TCGLookup({ apiKey: 'your-key' });
const cards = await tcg.search('charizard');
// 47 results, real-time prices from TCGPlayer + eBay

const card = await tcg.getCard('pokemon-sv4-charizard-ex-006');
// Market price, per-condition, PSA/BGS/CGC graded values

Как работает TCG API

От нуля до получения данных о ценах карт за 5 минут. Три шага, никакой настройки.

01

Получите бесплатный API-ключ

Зарегистрируйтесь на tcgpricelookup.com — кредитная карта не нужна. API-ключ выдаётся немедленно и работает для всех 8 поддерживаемых игр. Бесплатный тариф даёт 200 запросов в день для немедленного начала разработки.

API key: tpl_live_xxxxxxxxxxxx
02

Установите SDK

Выберите предпочтительный язык. Официальные SDK доступны для JavaScript, Python, Go, Rust и PHP. Каждый SDK поддерживается командой TCG Price Lookup с полными определениями типов.

$ npm install tcglookup
03

Получайте цены карт

Ищите по названию, набору или ID. Получайте рыночные цены TCGPlayer и eBay в реальном времени, цены по состоянию, цены на градированные карты и историю цен — всё из одного API.

search GET /v1/search?q=charizard
card GET /v1/cards/:id
history GET /v1/cards/:id/prices
batch POST /v1/cards/batch

Что можно построить

API цен на коллекционные карты используется для всего — от хобби-скриптов до production-торговых приложений.

💰

Инструменты сравнения цен

Показывайте рыночные цены TCGPlayer и завершённые продажи eBay рядом. Покупатели находят лучшие предложения, продавцы устанавливают конкурентные цены.

📊

Трекеры портфолио

Позвольте коллекционерам вносить карты и отслеживать стоимость коллекции во времени. Используйте эндпоинт истории цен для построения графиков прибылей и убытков.

🤖

Discord-боты

Добавьте слэш-команды на TCG Discord-серверы, чтобы участники могли проверять цены карт прямо в чате. Open-source стартер Discord-бота для всех 8 игр разворачивается за считанные минуты.

🔄

Торговые приложения

Улучшайте интерфейсы покупки/продажи/обмена данными о ценах в реальном времени. Показывайте справедливые торговые значения, обнаруживайте выгодные лоты, пакетно получайте цены для целых деклистов.

🔔

Оповещения о ценах

Отслеживайте конкретные карты и уведомляйте пользователей, когда цены пересекают пороговые значения. Используйте запланированный опрос или Webhook-уведомления в платных планах.

📈

Аналитические дашборды

Стройте графики истории цен, анализируйте тренды по наборам, оценивайте рыночную капитализацию наборов. Эндпоинт истории цен предоставляет ежедневные снимки за месяц.

TCG API для всех игр

Один API-ключ для 8 игр. Pokemon TCG API, MTG API, Yu-Gi-Oh! API, Lorcana, One Piece и другие — всё через один унифицированный интерфейс.

Pokemon

30,000+ cards

Access real-time pricing for over 30,000 Pokemon TCG cards. Search by name, set, or card number. Get per-condition pricing from Near Mint to Damaged, plus PSA, BGS, and CGC graded values.

Документация Pokemon API →
Pokemon API example JavaScript
const results = await tcg.search('charizard', { game: 'pokemon' });
// Returns: prices for all Charizard cards across all sets

Magic: The Gathering

100,000+ cards

Access real-time pricing for over 100,000 Magic: The Gathering cards. Complete coverage of all sets from Alpha to the latest release. Per-condition and graded pricing.

Документация Magic: The Gathering API →
Magic: The Gathering API example JavaScript
const results = await tcg.search('black lotus', { game: 'mtg' });
// Returns: prices for Black Lotus across all editions

Yu-Gi-Oh!

40,000+ cards

Access real-time pricing for over 40,000 Yu-Gi-Oh! cards. Coverage spans all sets and rarities with per-condition and graded card values.

Документация Yu-Gi-Oh! API →
Yu-Gi-Oh! API example JavaScript
const results = await tcg.search('blue-eyes white dragon', { game: 'yugioh' });
// Returns: prices for Blue-Eyes White Dragon across all sets

Disney Lorcana

3,000+ cards

Access real-time pricing for over 3,000 Disney Lorcana cards. Full coverage since launch with per-condition pricing and graded values.

Документация Disney Lorcana API →
Disney Lorcana API example JavaScript
const results = await tcg.search('elsa', { game: 'lorcana' });
// Returns: prices for all Elsa cards

One Piece

6,000+ cards

Access real-time pricing for over 6,000 One Piece TCG cards. Complete set coverage with per-condition pricing and graded values.

Документация One Piece API →
One Piece API example JavaScript
const results = await tcg.search('luffy', { game: 'onepiece' });
// Returns: prices for all Luffy cards

Pokemon Japan

20,000+ cards

Access real-time pricing for over 20,000 Japanese Pokemon TCG cards. Covers Japanese-exclusive sets, promos, and special releases.

Документация Pokemon Japan API →
Pokemon Japan API example JavaScript
const results = await tcg.search('pikachu', { game: 'pokemonjp' });
// Returns: prices for Japanese Pikachu cards

Star Wars: Unlimited

2,500+ cards

Access real-time pricing for over 2,500 Star Wars: Unlimited cards. Full coverage with per-condition pricing and graded values.

Документация Star Wars: Unlimited API →
Star Wars: Unlimited API example JavaScript
const results = await tcg.search('darth vader', { game: 'swu' });
// Returns: prices for all Darth Vader cards

Flesh and Blood

8,000+ cards

Access real-time pricing for over 8,000 Flesh and Blood cards. Complete coverage with per-condition pricing and graded values.

Документация Flesh and Blood API →
Flesh and Blood API example JavaScript
const results = await tcg.search('bravo', { game: 'fab' });
// Returns: prices for all Bravo cards

Сравнение TCG API

Сравнение TCG Price Lookup с Scryfall, pokemontcg.io, TCGPlayer API и самодельными парсерами.

Функция TCG Price Lookup Scryfall API pokemontcg.io TCGPlayer API Самодельный парсер
Количество игр 8 игр Только MTG Только Pokemon Много (непостоянно) Любые
Цены в реальном времени Частично (TCGP) ✓ (только TCGP) Зависит
Цены по состоянию Вручную
Цены градированных (PSA/BGS/CGC) Вручную
Официальные SDK 5 языков Только сообщество 1 (JS)
Бесплатный тариф ✓ 200 запросов/день Нет данных о ценах Нет данных о ценах Нужна заявка ✓ (за свой счёт)
История цен Ограничено Самостоятельно

Экосистема разработчиков

Помимо REST API — официальные SDK для 5 языков, готовые инструменты и полная документация для разработчиков.

Официальные SDK — 6 языков

CLI Tool

GitHub →

Live trading card prices in your terminal. Search, lookup, price history, JSON output for scripting. Also installable via npm.

$ brew tap TCG-Price-Lookup/tcg && brew install tcglookup
  • Search cards from terminal
  • Price history lookups
  • JSON output for scripting

Go SDK

GitHub →

Official Go SDK for the TCG Price Lookup API. Idiomatic Go, stdlib net/http, zero third-party deps, functional options, typed errors.

$ go get github.com/TCG-Price-Lookup/tcglookup-go
  • Zero third-party dependencies
  • Idiomatic Go design
  • Functional options pattern

JavaScript / TypeScript SDK

GitHub →

Official JavaScript/TypeScript SDK for the TCG Price Lookup API. Zero deps, ESM + CJS, works in Node 18+, browsers, Bun, Deno, Cloudflare Workers.

$ npm install tcglookup
  • Zero dependencies
  • ESM and CommonJS support
  • Full TypeScript types

PHP SDK

GitHub →

Official PHP SDK for the TCG Price Lookup API. PHP 8.1+, Guzzle, PSR-4, typed exception hierarchy.

$ composer require tcg-price-lookup/tcglookup
  • PHP 8.1+ support
  • Guzzle HTTP client
  • PSR-4 autoloading

Python SDK

GitHub →

Official Python SDK for the TCG Price Lookup API. Python 3.9+, built on httpx, typed exception hierarchy, context manager support.

$ pip install tcglookup
  • Python 3.9+ support
  • Built on httpx (async ready)
  • Typed exception hierarchy

Rust SDK

GitHub →

Official Rust SDK for the TCG Price Lookup API. Async with reqwest + tokio, typed Error enum, builder pattern.

$ cargo add tcglookup
  • Async with reqwest + tokio
  • Typed Error enum
  • Builder pattern

Инструменты и ресурсы — 5 инструментов

Awesome TCG

list

Curated list of the TCG Price Lookup ecosystem — REST API, 5 SDKs, CLI, code examples in 8 languages, blog tutorials.

github.com/TCG-Price-Lookup/awesome-tcg#readme →

Discord Bot

bot

Self-hosted Discord bot for live trading card prices. Slash commands powered by the TCG Price Lookup API. Supports all 8 games.

github.com/TCG-Price-Lookup/tcg-discord-bot#readme →

Next.js Starter

starter

One-click deployable Next.js 16 starter for the TCG Price Lookup API. Search live trading card prices across 8 games out of the box.

$ npx create-next-app -e https://github.com/TCG-Price-Lookup/nextjs-tcg-starter

OpenAPI Specification

spec

OpenAPI 3.1 specification for the TCG Price Lookup API. Use with Swagger UI, Redoc, Postman, or any OpenAPI-compatible tool.

github.com/TCG-Price-Lookup/tcg-api-openapi#readme →

Postman Collection

collection

Ready-to-use Postman collection and environment for the TCG Price Lookup API. Import, set your API key, and start testing.

github.com/TCG-Price-Lookup/tcg-api-postman#readme →

Часто задаваемые вопросы

От начала работы с TCG Price Lookup API до лимитов запросов и цен на градированные карты.

Что такое TCG API?

+

TCG API (API для коллекционных карточных игр) — это веб-сервис, предоставляющий программный доступ к данным о картах. Вы можете получать информацию о картах, данные о наборах и рыночные цены в реальном времени. Разработчики используют TCG API для создания трекеров цен, портфолио-инструментов, Discord-ботов и многого другого.

Является ли TCG Price Lookup API бесплатным?

+

Да, TCG Price Lookup предлагает бесплатный тариф с 200 запросами в день для хобби-проектов и прототипов (только некоммерческое использование). Платные планы предоставляют более высокие лимиты, эндпоинты истории цен, цены eBay, цены на градированные карты и права на коммерческое использование. Кредитная карта не нужна.

Какие коллекционные карточные игры поддерживаются?

+

Поддерживаются 8 игр: Pokemon TCG (английская версия), Pokemon (японская версия), Magic: The Gathering, Yu-Gi-Oh!, Disney Lorcana, One Piece Card Game, Star Wars: Unlimited, Flesh and Blood. Все игры используют одни и те же унифицированные эндпоинты поиска и карточек.

Как получить API-ключ для Pokemon TCG?

+

Зарегистрируйтесь на tcgpricelookup.com и подтвердите email — API-ключ будет выдан немедленно. Никакого процесса одобрения нет. Вы можете сразу же делать запросы к Pokemon TCG API (и всем другим играм).

Поддерживаются ли цены на градированные карты (PSA, BGS, CGC)?

+

Да. Доступны цены на градированные карты PSA (оценки 1–10), Beckett (BGS 7–10, включая 9.5 и 10 Black Label) и CGC (оценки 1–10). Цены на градированные карты берутся из данных продаж eBay. Требуется план Trader или выше.

Каковы лимиты запросов API?

+

Бесплатный план: максимум 200 запросов в день (скорость: 1 запрос/3 сек). Trader ($14.99/мес): 10 000 запросов в день (скорость: 1 запрос/сек). Business ($89.99/мес): 100 000 запросов в день (скорость: 3 запроса/сек). Дневные лимиты сбрасываются в полночь UTC.

Какие SDK доступны?

+

Есть 5 официальных SDK: JavaScript/TypeScript (npm install tcglookup), Python (pip install tcglookup), Go (go get github.com/TCG-Price-Lookup/tcglookup-go), Rust (cargo add tcglookup), PHP (composer require tcg-price-lookup/tcglookup). Также доступен CLI-инструмент для работы из терминала.

Как часто обновляются цены на карты?

+

Цены на карты обновляются непрерывно. Рыночные цены TCGPlayer обновляются каждые несколько часов по мере поступления новых данных о продажах. Записи eBay о завершённых продажах обновляются ежедневно. Для наиболее чувствительных ко времени приложений можно отслеживать тренды через эндпоинт истории цен.

Начните разработку с TCG API уже сегодня

Бесплатный тариф включён. Кредитная карта не нужна. Мгновенный доступ к более чем 300 000 карт из 8 игр.