نقاط نهاية API

مرجع كامل لنقاط نهاية البحث والتفاصيل والسجل والمجموعات والألعاب والدفعات في TCG Price Lookup API.

عنوان 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"

جلب بيانات الأسعار التفصيلية لبطاقة بمعرّفها.

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"]
}