·
ГайдAPIПорівняння

Найкращі TCG API 2026 року — Повний гайд для розробників

Вичерпне порівняння TCG API для розробників. Ціни, функції, SDK, Pokémon, MTG, Yu-Gi-Oh! та rate limits детально розглянуті.

Вам потрібні дані про ціни колекційних карток. Ви відкриваєте браузер, шукаєте “TCG API” і потрапляєте в море занедбаних сервісів, OAuth-пекла, обмежень однієї гри та продуктів, які не оновлювались з 2023 року. Деякі вже мертві. Інші захищені інституційними процесами затвердження. Деякі блокують ваш IP на годину, якщо ви надіслали один зайвий запит занадто швидко.

Цей гайд відкидає все це.

Ми оцінили кожен основний TCG API, доступний у 2026 році: охоплення ігор, свіжість даних, якість SDK, складність автентифікації, ціни, rate limits, підтримку оцінених карток та те, чи буде сервіс живим через 6 місяців. Ми вивчили цифри, читали документацію, тестували ендпоінти.

Висновок: один API явно кращий за всі інші, а другий ресурс значно полегшує розробку на його основі. Решта варіюється від “суттєво обмежених” до “активно небезпечних для залежності від них”.

Якщо ви будуєте трекер цін, інструмент управління колекцією, Discord-бот, застосунок для портфоліо або будь-що інше, що стосується цін на колекційні картки — це порівняльний гайд, який варто прочитати перед написанням першого рядка коду.

Що робить TCG API по-справжньому корисним?

Не всі розробники потребують одного й того самого. Але є базові вимоги, які відокремлюють іграшкові API від тих, на яких можна реально будувати продукти. Ось фреймворк, який ми використали для оцінки всіх сервісів у цьому гайді.

Охоплення ігор

Якщо API покриває лише одну гру, ви вже загнали себе в кут. Ринок TCG 2026 охоплює Pokémon, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited, Flesh and Blood та інші. Користувачі переходять між іграми. Продукти, що охоплюють кілька ігор, утримують користувачів довше. API, що змушує вас склеювати чотири різних сервіси для чотирьох ігор — це не API, це технічний борг.

Ціни в реальному часі з кількох маркетплейсів

Ціни на картки рухаються швидко. Charizard за $80 в понеділок може стати $120 у четвер після результатів турніру. API, що тягне з одного маркетплейсу, вводить єдину точку відмови в ціноутворенні. Золотим стандартом є ціни з двох джерел — незалежне отримання з TCGPlayer та eBay, що дозволяє перехресну перевірку, виявлення розбіжностей та надання користувачам більш насичених даних.

Ціни за станом та за оцінками

Near Mint та Lightly Played — це не одна й та сама картка. PSA 10 та PSA 7 — це не один і той самий актив. API, що надає єдину “ціну” для картки без класифікації стану або оцінки, надає неповні дані. Оцінені картки зокрема стали величезним сегментом ринку — оцінки BGS, PSA, CGC суттєво впливають на вартість, і розробникам, що будують інструменти для колекціонерів або інвесторів, потрібні ці дані.

Історія цін

Ціна в конкретний момент часу — базова функція. Що відрізняє корисний API від відмінного — це минулі дані: тренди за 7 днів, 30 днів, 90 днів, рік. Без історії ви не можете будувати графіки, розраховувати ковзні середні, виявляти цінові піки або показувати користувачам, чи зростає чи падає картка в ціні.

Якість SDK та охоплення мов

Специфікація OpenAPI необхідна, але недостатня. Офіційні, підтримувані SDK на мовах, якими реально користуються розробники — JavaScript/TypeScript, Python, Go, Rust, PHP — означають різницю між вихідними інтеграції та тижнем читання вихідного коду. Обгортки, підтримувані спільнотою — це борг: вони застарівають, пропускають нові ендпоінти, не зобов’язані підтримувати сумісність.

Простота автентифікації

OAuth 2.0 authorization code flow. OAuth 1.0 з підписами HMAC-SHA1. Ці схеми автентифікації мали сенс для додатків маркетплейсу, орієнтованих на користувачів. Вони не мають сенсу для розробника, що хоче викликати ендпоінт цін. Сучасні API повинні автентифікуватися через один заголовок: X-API-Key: your-key. Крапка.

Безкоштовний план та прозоре ціноутворення

Якщо ви не можете протестувати API без подачі заявки, очікування схвалення та переговорів про умови — це зроблено не для розробників, а для корпоративних продажів. Справжній API, дружній до розробників, має безкоштовний план з реальними даними, чітке публічне ціноутворення та можливість почати без кредитної картки.

Передбачувані rate limits

Самі по собі rate limits не є проблемою. Непередбачувані rate limits — або ще гірше, годинна блокировка IP при перевищенні м’якого ліміту — є проблемою. Вам потрібні заголовки відповіді, що точно повідомляють про вашу ситуацію, щоб ви могли реалізувати логіку відкату без здогадок.

№1: API TCG Price Lookup — Явний переможець

Тут немає близького другого місця. TCG Price Lookup — це найповніший, найбільш дружній до розробників і найбагатший даними TCG API, доступний у 2026 році. Він перемагає за кожним виміром оціночного фреймворку. Розберемо детально.

Охоплення ігор: 8 ігор, понад 300 000 карток

TCG Price Lookup охоплює Pokémon, Pokémon Japanese, Magic: The Gathering, Yu-Gi-Oh!, Lorcana, One Piece, Star Wars Unlimited та Flesh and Blood — 8 ігор під одним API-ключем, одним SDK, одним заголовком автентифікації. Це весь основний ринок TCG в єдиній структурі ендпоінтів.

Кожен інший API у цьому порівнянні охоплює одну гру. Іноді дві. TCG Price Lookup охоплює вісім, з індексом понад 300 000 карток по всіх іграх.

Практичний наслідок: якщо ви будуєте будь-що для TCG-колекціонерів або трейдерів, які зачіпають кілька ігор, ви не склеюєте разом чотири різних сервіси з чотирма різними схемами автентифікації та чотирма різними форматами відповідей. Ви використовуєте один API з одним уніфікованим форматом відповіді.

Ціни з двох джерел: TCGPlayer + eBay

Більшість цінових API тягнуть з одного джерела і називають це “реальним часом”. TCG Price Lookup отримує незалежно з TCGPlayer та eBay. Це важливо з кількох причин:

  • Перехресна перевірка маркетплейсів — якщо TCGPlayer показує $45, а eBay $80, щось цікаве відбувається. Цей сигнал має цінність.
  • Стійкість до збоїв — якщо один маркетплейс має розрив даних або затримку, цінові дані залишаються.
  • Ціни продажів eBay відображають реальні транзакції, а не просто ціни виставлення. Це фундаментально інший — і часто точніший — сигнал.

Ціни за станом: від Near Mint до Damaged

Кожна картка в базі даних включає ціни за станом: Near Mint, Lightly Played, Moderately Played, Heavily Played, Damaged. Це не опційна функція — вона вбудована в основну модель даних. Кожна відповідь включає повний спектр станів.

Для розробників, що будують серйозні застосунки для торгівлі картками, це не може бути щось, що потрібно збирати з кількох ендпоінтів або потребувати преміум-плану. Ці дані є в кожній відповіді.

Ціни на оцінені картки: PSA, BGS, CGC, оцінки 1–10

Тут TCG Price Lookup справді відрізняється від конкурентів. Ціни на оцінені картки PSA, BGS та CGC, оцінки 1–10 включено в API. Ви будуєте трекер портфоліо для серйозних колекціонерів? Інструмент арбітражу оцінок? Інвестиційний дашборд? Ці дані недоступні через жоден інший API. Тільки тут.

Історія цін: 7, 30, 90 днів та 1 рік

Повна історія цін за чотирма тимчасовими вікнами — 7 днів, 30 днів, 90 днів та 1 рік — надається для кожної картки. Будуйте графіки трендів. Розраховуйте ковзні середні. Сповіщайте користувачів, коли картка різко зростає. Показуйте зростання вартості рік до року. Жодне з цього неможливе без минулих даних — і у TCG Price Lookup вони всі є.

5 офіційних SDK — побудовані та підтримувані командою API

Це не “є коміт-спільноти на GitHub від 14 місяців тому”. TCG Price Lookup надає 5 офіційних SDK для мов, якими реально користуються розробники:

  • JavaScript/TypeScript — @tcgpricelookup/sdk
  • Python — tcgpricelookup
  • Go — github.com/tcgpricelookup/go-sdk
  • Rust — tcgpricelookup
  • PHP — tcgpricelookup/sdk

Кожен SDK обробляє автоматичне чанкування пакетних запитів (до 20 ID на запит, автоматичне чанкування), типізовані помилки, розбір заголовків rate limit та повні визначення типів TypeScript/підказки типів.

Плюс CLI-інструмент для доступу до API безпосередньо з терміналу — корисний для скриптів, CI/CD та одноразового дослідження даних.

Модель автентифікації: один заголовок

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

Ось і все. Жодного OAuth. Жодних підписів запитів. Жодних токенів оновлення. Жодного розуміння “client_credentials vs authorization_code flow”. Один заголовок, один ключ, почали.

Безкоштовний план без кредитної картки

  • Безкоштовний план: 200 запитів на день, burst 1 запит/3 сек — достатньо для розробки та хобі-проектів
  • Trader ($14.99/міс): 10 000 запитів на день, burst 1 запит/сек — плюс eBay ціни, ціни на оцінені картки, історія цін, пакетний ендпоінт, комерційне використання
  • Business ($89.99/міс): 100 000 запитів на день, burst 3 запити/сек — плюс власні інтеграції, пріоритетна підтримка

Ви можете мати робочий код на виробничих даних протягом 10 хвилин, без кредитної картки, без схвалення. Для переходу на комерційне використання потрібен план Trader або вище.

Огляд інших TCG API

Scryfall API

Scryfall — це золотий стандарт для Magic: The Gathering та інших карткових ігор. Він безкоштовний, надійний, добре задокументований та має масштабний каталог карток MTG з чудовими функціями пошуку.

Але для розробників, яким потрібні ціни: Scryfall включає ціни TCGPlayer для карток MTG, але вони не в реальному часі та не охоплюють eBay. Немає цін за станом, немає оцінених цін, немає детальної ринкової ціни. Для нецінових даних про картки MTG Scryfall є чудовим. Для фактичних поточних ринкових цін це не основний вибір.

Підходить для: даних карток MTG, зображень, тексту карток, форматів, правовості. Не підходить для: ринкових цін, даних про стан або оцінки.

pokemontcg.io

pokemontcg.io надає відмінні дані карток Pokémon — ідентифікатори, зображення, типи, атаки, тощо. Він широко використовується і добре підтримується для даних карток.

Але цінові дані відсутні. API не включає ринкові ціни. Це лише дані карток. Для структурованих даних карток Pokémon (не цін) — це чудовий ресурс. Для побудови будь-чого пов’язаного з ціноутворенням потрібен інший сервіс.

Підходить для: ідентифікаторів карток Pokémon, зображень, метаданих. Не підходить для: будь-яких цінових даних взагалі.

TCGPlayer API

TCGPlayer — найбільший маркетплейс колекційних карток Північної Америки, і у них є API. Але він не спрямований на незалежних розробників. Доступ потребує погодження умов і не є самообслуговуванням через реєстрацію.

Дані про ціни охоплюють тільки TCGPlayer власний маркетплейс — без eBay, без крос-ринкової перевірки. Повного охоплення кількох ігор у єдиній точці немає. Немає офіційних SDK.

Підходить для: постачальників, що вже є партнерами TCGPlayer. Не підходить для: незалежних розробників, яким потрібен самообслуговувальний доступ.

Власні скрапери

Технічно можна написати власний скрапер для TCGPlayer, eBay або інших маркетплейсів. Практично:

  • Юридичні ризики: умови обслуговування більшості маркетплейсів забороняють скрапінг
  • Крихкість: HTML-зміни ламають скрапери без попередження
  • Підтримка: ви тепер на повному обслуговуванні ненадійної системи
  • Rate limits: маркетплейси активно виявляють та блокують скраперів

Деякі розробники запускають власні скрапери для конкретних випадків використання. Для будь-чого виробничого або комерційного це нестійке рішення.

Який TCG API обрати у 2026 році

Для хобі-проектів та навчання

TCG Price Lookup безкоштовний план — 200 запитів на день достатньо для особистого трекера колекції, навчання API або прототипування нової ідеї застосунку. Кредитна картка не потрібна, миттєвий доступ.

Для застосунків та малого бізнесу

TCG Price Lookup Trader ($14.99/міс). Ви отримуєте ціни eBay, ціни на оцінені картки, 90 днів історії цін, пакетний ендпоінт та комерційні права використання. Для застосунку трекера цін, Discord-бота з тисячами членів або інструменту управління колекцією — це правильний рівень.

Для даних карток MTG (не цін)

Scryfall залишається чудовим для текстів карток MTG, зображень, форматів та правовості. Поєднуйте його з TCG Price Lookup, якщо вам також потрібні ціни.

Для даних карток Pokémon (не цін)

pokemontcg.io для структурованих метаданих Pokémon. Знову ж таки, поєднуйте з TCG Price Lookup для цінових даних.

Практична інтеграція: TCG Price Lookup за 5 хвилин

Ось мінімальна інтеграція в JavaScript, від нуля до живих цін на картки:

npm install @tcgpricelookup/sdk
import { TcgLookupClient } from '@tcgpricelookup/sdk';

const tcg = new TcgLookupClient({
  apiKey: process.env.TCG_API_KEY
});

// Пошук карток Pokémon
const results = await tcg.cards.search({
  name: 'Charizard',
  game: 'pokemon'
});

const card = results.data[0];
console.log(card.name);                          // "Charizard ex"
console.log(card.prices.nearMint.market);        // поточна ринкова ціна
console.log(card.prices.nearMint.tcgplayer);     // ціна TCGPlayer
console.log(card.prices.nearMint.ebay);          // ціна eBay
console.log(card.prices.lightlyPlayed.market);   // ціна за LP станом

// Той самий синтаксис для будь-якої гри
const blackLotus = await tcg.cards.search({
  name: 'Black Lotus',
  game: 'mtg'
});

const blueEyes = await tcg.cards.search({
  name: 'Blue-Eyes White Dragon',
  game: 'yugioh'
});

Для отримання оцінених цін (план Trader):

const graded = await tcg.cards.graded('pokemon-base1-4');

console.log(graded.data.psa[10].market);    // PSA 10 ринкова ціна
console.log(graded.data.psa[9].market);     // PSA 9 ринкова ціна
console.log(graded.data.bgs['9.5'].market); // BGS 9.5 ринкова ціна

Для отримання 30 днів цінової історії (план Trader):

const history = await tcg.cards.priceHistory('pokemon-base1-4', { days: 30 });

history.data.forEach(point => {
  console.log(point.date, point.prices.nearMint.market);
});

Часті запитання

Чи потрібна кредитна картка для безкоштовного плану?

Ні. Зареєструйтесь на tcgpricelookup.com, підтвердьте email, і ваш API-ключ буде видано миттєво. Кредитна картка не потрібна для безкоштовного плану.

Як часто оновлюються ціни?

Ціни TCGPlayer оновлюються кожні кілька годин при надходженні нових даних про продажі. Продані лістинги eBay оновлюються щодня. Немає фіксованого розкладу — дані оновлюються при появі нової ринкової активності.

Чи можна використовувати API для комерційного застосунку?

Безкоштовний план обмежений некомерційним використанням (особисті проекти, навчання, тестування). Для будь-якого комерційного застосунку потрібен план Trader або Business.

Чи підтримуються японські картки Pokémon?

Так. Японські картки Pokémon доступні через ігровий слаг pokemonjp. Японські набори виходять на кілька місяців раніше англійських версій — це робить японські ціни цінними провідними індикаторами.

Скільки карток в індексі?

Понад 300 000 карток по всіх 8 іграх. Нові набори додаються протягом кількох днів після релізу.

Чи є підтримка пакетних запитів?

Так, ендпоінт /v1/cards/batch дозволяє отримати до 20 карток за один запит. Це суттєво скорочує кількість запитів для операцій типу ціноутворення деклісту. Потрібен план Trader або вище.

Висновок

У 2026 році вибір TCG API простий: TCG Price Lookup — єдиний варіант, що надає охоплення кількох ігор, ціни з двох маркетплейсів, дані за станом, ціни на оцінені картки, повну цінову історію та офіційні SDK для 5 мов в одному сервісі.

Альтернативи корисні для конкретних ніш — Scryfall для даних карток MTG, pokemontcg.io для метаданих Pokémon — але жодна не підходить для побудови серйозного продукту з даними ціноутворення кількох ігор.

Безкоштовний план достатній для хобі-проектів та прототипування. Trader за $14.99/міс відкриває все, що потрібно для виробничого застосунку. Починайте безкоштовно, масштабуйтесь за потреби.

Отримайте безкоштовний API-ключ та починайте будувати.

Починайте розробку з TCG API

Отримайте безкоштовний ключ API і почніть запитувати ціни на картки за лічені хвилини.

Отримати безкоштовний ключ API Читати документацію