API Endpoints

TCG Price Lookup API के search, card details, price history, sets, games और batch search endpoints का complete reference।

Base URL

https://api.tcgpricelookup.com/v1

Name से सभी games के cards search करें।

GET /v1/search

Query Parameters:

Parameter	Required	Description
`q`	हां	Search query (card name)
`game`	नहीं	Game slug (जैसे: `pokemon`, `mtg`, `yugioh`)
`set`	नहीं	Set name या set code से filter
`rarity`	नहीं	Rarity से filter
`limit`	नहीं	Results count (default: 20, max: 100)
`offset`	नहीं	Pagination offset

उदाहरण:

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

ID से card का detailed price data प्राप्त करें।

GET /v1/cards/:id

उदाहरण:

curl "https://api.tcgpricelookup.com/v1/cards/pokemon-base1-4" \
  -H "X-API-Key: your-api-key"

Card की price history प्राप्त करें (Trader plan या उससे ऊपर)।

GET /v1/cards/:id/prices

Query Parameters:

Parameter	Default	Description
`days`	30	History के दिन (max: 90)

किसी specific game के सभी sets list करें।

GET /v1/sets?game=pokemon

एक request में 20 cards तक fetch करें (Trader plan या उससे ऊपर)।

POST /v1/cards/batch

Request Body:

{
  "ids": ["pokemon-base1-4", "mtg-lea-232", "yugioh-lob-005"]
}