Search

Search cards and sealed products by name across all supported games.

Search Cards

GET /v1/search

Authentication: API key required

Query Parameters:

Parameter	Type	Required	Description
`q`	string	Yes	Search query (min 2 characters)
`game`	string	No	Filter by game slug
`set_id`	integer	No	Filter by set ID
`rarity`	string	No	Filter by rarity
`type`	string	No	`Cards` or `Sealed Products`
`printing`	string	No	`Normal` or `Foil`
`min_price`	number	No	Minimum market price
`max_price`	number	No	Maximum market price
`sort`	string	No	Sort order (see below)
`page`	integer	No	Page number (default: 1)
`per_page`	integer	No	Results per page (default: 50, max: 100)

Sort Options:

Value	Description
`relevance`	Best match (default)
`price_asc`	Cheapest first
`price_desc`	Most expensive first
`name`	Alphabetical A-Z

Example:

# Search for Charizard in Pokemon, sorted by price
curl "https://api.tcgapi.dev/v1/search?q=charizard&game=pokemon&sort=price_desc" \
  -H "X-API-Key: YOUR_KEY"

# Search for sealed products only
curl "https://api.tcgapi.dev/v1/search?q=booster+box&game=pokemon&type=Sealed+Products" \
  -H "X-API-Key: YOUR_KEY"

Response:

{
  "data": [
    {
      "id": 12345,
      "name": "Charizard ex",
      "clean_name": "charizard ex",
      "number": "006",
      "rarity": "Double Rare",
      "image_url": "https://...",
      "tcgplayer_id": 534280,
      "product_type": "Cards",
      "foil_only": 0,
      "total_listings": 847,
      "set_name": "Obsidian Flames",
      "game_name": "Pokemon",
      "game_slug": "pokemon",
      "printing": "Normal",
      "market_price": 24.99,
      "low_price": 19.50,
      "median_price": 26.50,
      "lowest_with_shipping": 20.99,
      "price_updated_at": "2026-02-19T07:00:00.000Z"
    }
  ],
  "meta": {
    "total": 847,
    "page": 1,
    "per_page": 50,
    "has_more": true
  },
  "rate_limit": {
    "daily_limit": 100,
    "daily_remaining": 95,
    "daily_reset": "2026-02-20T00:00:00.000Z"
  }
}

Search Tips

Searches match against clean_name (alphanumeric, lowercased)
Use game filter to narrow results and improve relevance
Partial names work: "chariz" will match "Charizard"
Special characters are stripped: searching "Dark Magician" and "dark magician" return the same results
Use type=Sealed Products to find booster boxes, tins, ETBs, and cases
Use printing=Foil to see only foil/holo variant prices
Combine min_price and max_price for budget-conscious searches