Everything you need to start using the TCG Price Lookup API.
Base URL
https://api.tcgpricelookup.com/v1Create a free account to get your API key. No credit card required.
Include your API key in the X-API-Key header of every request.
curl "https://api.tcgpricelookup.com/v1/cards/search?q=charizard&game=pokemon" \
-H "X-API-Key: YOUR_API_KEY"All list endpoints return a consistent envelope with a data array and pagination fields. Use limit and offset query parameters to paginate through results.
{
"data": [
{
"id": "019535a1-d5d0-7c12-a3e8-b7f4c6d8e9a2",
"name": "Charizard ex",
"game": "pokemon",
"set_name": "Obsidian Flames",
"rarity": "Double Rare",
"prices": {
"raw": {
"near_mint": {
"tcgplayer": { "market": 48.97 },
"ebay": { "avg_7d": 50.75 }
}
}
}
}
],
"total": 47,
"limit": 20,
"offset": 0
}The catalog is organized as games (Pokémon, Magic, etc.), each containing sets, each containing cards. Every card has a stable id (UUID) you can fetch directly.
Each card carries a prices object, split into raw (by condition) and graded (by grader and grade), sourced from TCGplayer and eBay. See the prices reference.
The same endpoints serve every plan; the fields and quotas differ. Free returns TCGplayer raw prices, paid plans add eBay and graded data and price history. See rate limits.
List endpoints page with limit / offset, and you can fetch up to 100 cards at once with /v1/cards/search?ids=. Full details in the API reference.
Filter any card or set query by these game slugs.
pokemonpokemon-jpmtgyugiohonepiecelorcanaswufabSDKs & Tools
Official JS, Python, Go, Rust and PHP SDKs, CLI, OpenAPI spec and more
Authentication
API key setup & security
API Reference
Interactive endpoint docs
Rate Limits
Limits, headers & errors
LLM Integration
Grounded retrieval patterns for AI assistants
Realtime Patterns
Polling, backoff, and update stream architecture