Public REST API v1

TCG Collectors Public API

Integrate third-party apps, crawlers, and store tools with our trading card catalog and public marketplace.

1Authentication

All third-party requests are served under /v1 and require an API key in the X-API-Key HTTP header.

X-API-Key: tcg_••••••••

2Scopes & Permissions

Granular scopes control endpoint access: cards:read, sets:read, marketplace:read, or *.

3Rate Limits

Each API key is limited to 60 requests per minute. Exceeding this limit returns HTTP 429 Too Many Requests.

Endpoints Reference

Endpoints

GET/v1/cards

List & Search Cards

Scope: cards:read / catalog:read

Retrieve a paginated list of catalog cards with extensive filtering (game, set, category, rarity, language). Also available under alias /v1/items.

Parameters

Parameter	Type	Description
q	string	Search name, SKU, or collector number
game	string	Filter by game code (e.g. pokemon, one-piece)
set	string	Filter by set code (e.g. SV01)
rarity	string	Filter by rarity (e.g. Rare Holo, Common)
language	string	Filter by language code (e.g. en, id, ja)
category	string	Category code (includes all subcategories)
sort	string	Sort by name, newest, or collector_number
page	integer	Page number (default: 1)
per_page	integer	Items per page (1-100, default: 25)

curl -X GET "https://api.tcgcollectors.com/v1/cards" \
  -H "X-API-Key: tcg_your_api_key_here" \
  -H "Accept: application/json"

Example 200 OK Response

{
  "success": true,
  "data": [
    {
      "sku": "PKM-SV01-025",
      "name": "Pikachu",
      "game": "pokemon",
      "set_code": "SV01",
      "set_name": "Scarlet & Violet Base",
      "collector_number": "025",
      "rarity": "Common",
      "language": "en",
      "released_at": "2026-01-20",
      "image_url": "https://collectors.tcg.local/media/catalog/pikachu.webp"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 1540,
    "last_page": 62
  }
}