API Endpoints
Cards
Fetch individual cards or paginated card lists across all TCGs.
List Cards
GET /public/v1/cards
Requires: Starter plan or higher
Query Parameters
| Parameter | Type | Description |
|---|---|---|
game | string | Required. Any of the 24 supported game keys — see Supported Games. |
name | string | Filter by card name (case-insensitive partial match) |
rarity | string | Filter by rarity |
groupId | number | Filter by set ID (groupId) |
page | number | Page number (default: 1) |
limit | number | Results per page (default: 100, max: 250) |
Example
curl "https://api.cardprices.io/public/v1/cards?game=pokemon&name=pikachu&limit=10" \
-H "X-API-Key: pub_live_YOUR_KEY"Response
Results are returned in a flat envelope. game is echoed at the top level, and the cards
themselves are under the cards array.
{
"game": "pokemon",
"total": 47,
"page": 1,
"limit": 10,
"totalPages": 5,
"cards": [
{
"_id": "60f1a0b2c3d4e5f6a7b8c9d0",
"name": "Pikachu",
"cleanName": "Pikachu",
"rarity": "Common",
"number": "58/102",
"groupId": 604,
"productId": 100001,
"image": "https://assets.pokemon.cardprices.io/100001.jpg",
"prices": {
"tcgplayer_url": "https://www.tcgplayer.com/product/100001",
"tcgplayer_prices": [
{
"subTypeName": "Normal",
"lowPrice": 0.75,
"midPrice": 1.10,
"highPrice": 2.50,
"marketPrice": 1.25,
"directLowPrice": 0.90
}
]
}
}
]
}Get Card
GET /public/v1/cards/:game/:cardId
Requires: Starter plan or higher
The :cardId can be either the MongoDB _id or the numeric TCGplayer productId.
Example
curl "https://api.cardprices.io/public/v1/cards/pokemon/100001" \
-H "X-API-Key: pub_live_YOUR_KEY"Response
Returns the full card document under the card key.
{
"card": {
"_id": "60f1a0b2c3d4e5f6a7b8c9d0",
"game": "pokemon",
"name": "Pikachu",
"cleanName": "Pikachu",
"rarity": "Common",
"number": "58/102",
"groupId": 604,
"productId": 100001,
"image": "https://assets.pokemon.cardprices.io/100001.jpg",
"prices": {
"tcgplayer_url": "https://www.tcgplayer.com/product/100001",
"tcgplayer_prices": [
{
"subTypeName": "Normal",
"lowPrice": 0.75,
"midPrice": 1.10,
"highPrice": 2.50,
"marketPrice": 1.25,
"directLowPrice": 0.90
}
]
}
}
}Prices are an array of print variants (subTypeName, e.g. Normal, Reverse Holofoil,
1st Edition), each with its own lowPrice / midPrice / highPrice / marketPrice. Read the
variant you care about rather than assuming a single price.