REST API for programmatic access to TCGSignal card search and price data. Available to Dealer plan subscribers.
All API requests require a Bearer token. Generate an API key from your Settings page.
Authorization: Bearer tcs_your_api_key_hereAPI keys start with tcs_ and are 48 characters long. Keep your key secret — it grants full API access to your account.
Requests
60 / hour
Window
Sliding
Format
JSON
Search the card catalog by name with optional game and limit filters.
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Search query (2-200 characters) |
| game | string | No | Filter by game: pokemon, mtg, yugioh, onepiece |
| limit | number | No | Results per page (1-100, default 20) |
curl -H "Authorization: Bearer tcs_your_api_key" \ "https://tcgsignal.com/api/v1/search?q=Charizard&game=pokemon&limit=5"
{
"results": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Charizard ex",
"game": "pokemon",
"set_name": "Obsidian Flames",
"set_code": "OBF",
"rarity": "Double Rare",
"collector_number": "125",
"image_url_small": "https://..."
}
],
"count": 1,
"query": "Charizard"
}Fetch current prices for a specific card across platforms and conditions.
| Name | Type | Required | Description |
|---|---|---|---|
| cardId | string (UUID) | Yes | Card ID from search results |
| platform | string | No | Filter by platform: tcgplayer, ebay, cardmarket |
| condition | string | No | Filter by condition: NM, LP, MP, HP, DMG |
curl -H "Authorization: Bearer tcs_your_api_key" \ "https://tcgsignal.com/api/v1/prices?cardId=550e8400-e29b-41d4-a716-446655440000"
{
"card_id": "550e8400-e29b-41d4-a716-446655440000",
"prices": [
{
"platform": "tcgplayer",
"condition": "NM",
"low_price": 22.50,
"avg_price": 25.99,
"market_price": 24.75,
"high_price": 29.99,
"last_updated": "2026-03-01T21:00:00Z"
},
{
"platform": "ebay",
"condition": "NM",
"low_price": 23.00,
"market_price": 26.50,
"last_updated": "2026-03-01T22:00:00Z"
}
],
"count": 2
}| Status | Description |
|---|---|
| 400 | Invalid parameters — check request format |
| 401 | Missing or invalid API key |
| 403 | API access requires Dealer plan |
| 500 | Internal server error |
Authorization header