Search Card Sets

Search for card sets with optional name and category filters.

Search the CardHedge database for sets by name and/or category. Useful for populating set dropdowns, browsing available sets, or finding specific product lines.

Parameters:

• search: Optional text query matched against set names (e.g., "Topps Chrome", "Pokemon 151")
• category: Optional category filter (e.g., "Baseball", "Basketball", "Pokemon", "Football")
• count: Number of results to return (1-100, default: 25)

Response includes:

• count: Number of sets returned
• sets: Array of set objects with name, year, category, image, and 30-day sales volume

Example curl:

# Search by name
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "search": "Pokemon 151",
       "count": 10
     }' \
     "https://api.cardhedger.com/v1/cards/set-search"

# Filter by category
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "category": "Baseball",
       "count": 25
     }' \
     "https://api.cardhedger.com/v1/cards/set-search"

# Combined search + category
curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "search": "Topps Chrome",
       "category": "Baseball",
       "count": 50
     }' \
     "https://api.cardhedger.com/v1/cards/set-search"

Returns matching sets with metadata and sales data.