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

أسرع
TCG Price API
للمطورين

واجهة برمجة تطبيقات لأسعار البطاقات في الوقت الفعلي لـ Pokemon و Magic: The Gathering و Yu-Gi-Oh! و Lorcana و One Piece و3 ألعاب أخرى. أكثر من 300,000 بطاقة، 5 SDKs رسمية، شاملة مستوى مجاني.

احصل على مفتاح API المجاني اقرأ التوثيق
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 دقائق. 3 خطوات بدون إعداد معقد.

01

احصل على مفتاح API مجاني

سجّل في tcgpricelookup.com — بدون بطاقة ائتمان. يُصدر مفتاح API فوراً وصالح لجميع الألعاب الـ8 المدعومة. تتضمن الخطة المجانية 200 طلب يومياً، كافية للبدء بالتطوير فوراً.

API key: tpl_live_xxxxxxxxxxxx
02

ثبّت SDK

اختر لغتك المفضلة. تتوفر SDK رسمية لـ JavaScript وPython وGo وRust وPHP. تحتفظ بها فريق TCG Price Lookup مع تعريفات كاملة للأنواع.

$ npm install tcglookup
03

احصل على أسعار البطاقات

ابحث باسم البطاقة أو المجموعة أو المعرّف. احصل على أسعار 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

ما يمكنك بناؤه

يُستخدم TCG Card Price API في كل شيء من سكريبتات الهواة إلى تطبيقات التداول الإنتاجية.

💰

أداة مقارنة الأسعار

اعرض أسعار TCGPlayer وeBay جنباً إلى جنب. يجد المشترون أفضل الصفقات ويضع البائعون أسعاراً تنافسية.

📊

متتبع المحفظة

يُدخل المجمّعون بطاقاتهم ويتابعون قيمة مجموعتهم عبر الزمن. استخدم نقطة نهاية سجل الأسعار لرسم بيانيات الأرباح والخسائر.

🤖

بوت Discord

أضف أوامر slash إلى خوادم TCG على Discord لمساعدة الأعضاء على البحث عن أسعار البطاقات دون مغادرة الدردشة. يدعم جميع الألعاب الـ8.

🔄

تطبيق التداول

عزّز واجهات البيع والشراء والمبادلة ببيانات الأسعار في الوقت الفعلي. اعرض قيم التبادل العادلة، اكتشف القوائم المنخفضة التقييم، وجلب الأسعار بالجملة لقوائم البطاقات الكاملة.

🔔

تنبيهات الأسعار

راقب بطاقات معينة وأبلغ المستخدمين عندما تتجاوز الأسعار حداً معيناً. استخدم الاستطلاع المجدول أو إشعارات Webhook في الخطط المدفوعة.

📈

لوحة تحليلات

ابنِ مخططات سجل الأسعار وتحليل اتجاهات المجموعات الكاملة وتقدير القيمة السوقية للمجموعات. توفر نقطة نهاية سجل الأسعار لقطات يومية شهرية.

TCG API لجميع الألعاب

مفتاح API واحد لـ8 ألعاب. بوكيمون 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 فقط بوكيمون فقط متعددة (متغيرة) أي شيء
أسعار الوقت الفعلي ✓ جزئي (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 →
قراءة توثيق API →

الأسئلة الشائعة

من البدء باستخدام TCG Price Lookup API إلى حدود المعدل وأسعار البطاقات المصنفة.

ما هو TCG API؟

+

TCG API (واجهة برمجة تطبيقات ألعاب بطاقات التداول) هي خدمة ويب توفر وصولاً برمجياً إلى بيانات البطاقات. يمكنك من خلالها الحصول على تفاصيل البطاقات ومعلومات المجموعات وأسعار السوق في الوقت الفعلي. يستخدم المطورون TCG API لبناء أدوات تتبع الأسعار وأدوات إدارة المجموعات وبوتات Discord.

هل TCG Price Lookup API مجاني؟

+

نعم، يوفر TCG Price Lookup الخطة المجانية بـ 200 طلب يومياً للمشاريع الهواة والنماذج الأولية (للاستخدام غير التجاري). توفر الخطط المدفوعة حدوداً أعلى للطلبات وسجل الأسعار ونقاط نهاية أسعار eBay وأسعار البطاقات المصنفة وحقوق الاستخدام التجاري. لا تحتاج إلى بطاقة ائتمان للبدء.

ما ألعاب بطاقات التداول المدعومة؟

+

ندعم حالياً 8 ألعاب: بوكيمون TCG (الإنجليزية)، بوكيمون اليابانية، Magic: The Gathering، Yu-Gi-Oh!، Disney Lorcana، One Piece Card Game، Star Wars: Unlimited، وFlesh and Blood. تستخدم جميع الألعاب نفس نقاط النهاية الموحدة للبحث والبطاقات.

كيف أحصل على مفتاح API لبوكيمون TCG؟

+

سجّل في tcgpricelookup.com وتحقق من بريدك الإلكتروني وستحصل على مفتاح API فوراً. بدون أي عملية موافقة، يمكنك البدء بإرسال طلبات إلى بوكيمون TCG API (وجميع الألعاب الأخرى) على الفور.

هل تدعمون أسعار البطاقات المصنفة (PSA، BGS، CGC)؟

+

نعم. يمكنك الحصول على أسعار البطاقات المصنفة لـ PSA (الدرجات 1-10)، Beckett (BGS 7-10، 9.5، 10 Black Label)، وCGC (الدرجات 1-10). تُجمع أسعار التصنيف من بيانات مبيعات eBay. يتطلب خطة Trader أو أعلى.

ما هي حدود معدل الطلبات؟

+

الخطة المجانية: 200 طلب/يوم (انفجار: 1 طلب/3 ثواني). خطة Trader (14.99$/شهر): 10,000 طلب/يوم (انفجار: 1 طلب/ثانية). خطة Business (89.99$/شهر): 100,000 طلب/يوم (انفجار: 3 طلبات/ثانية). تُعاد تهيئة الحدود اليومية عند منتصف الليل بالتوقيت العالمي المنسق.

ما 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 ألعاب.

احصل على مفتاح API المجاني اقرأ التوثيق