New

Global Search

Search across cards, sets, releases, and parallels simultaneously with fuzzy matching and relevance scoring

What This Does

Searches across cards, sets, releases, and parallels in a single query
Uses fuzzy matching so partial or approximate terms still find results
Returns results ranked by relevance score
Supports filtering by type, year, segment, and manufacturer

When To Use This

When you want to search everything at once instead of separate endpoints
When you have a natural language query like "michael jordan baseball"
When you're not sure if you're looking for a card, set, or release
For building search bars that return mixed result types

Real Example

Scenario

A collector wants to find anything related to "topps chrome 2023" — cards, sets, and releases all in one search.

Sample Request

GET

/v1/catalog/search?q=topps chrome 2023&take=15

What You Get Back

{
  "results": [
    {
      "type": "release",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "2023 Topps Chrome",
      "relevance": 9.8,
      "year": "2023",
      "manufacturerName": "Topps"
    },
    {
      "type": "set",
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Base Set",
      "relevance": 7.2,
      "year": "2023",
      "releaseName": "2023 Topps Chrome",
      "manufacturerName": "Topps"
    },
    {
      "type": "card",
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "name": "Shohei Ohtani",
      "relevance": 6.5,
      "year": "2023",
      "setName": "Base Set",
      "releaseName": "2023 Topps Chrome",
      "manufacturerName": "Topps"
    }
  ],
  "total_count": 342,
  "skip": 0,
  "take": 15
}