Card Search API: Unique Parameter

The card search API now supports a new optional unique parameter that gives you control over how duplicate card prints are handled in search results. This will not change the UI experience, since you can see all prints of a card on the card page.

What's New

Previously, search results would automatically deduplicate cards, showing only one print per unique card (by card name + version). Now you can choose between two modes:

unique=cards (Default)

This is the existing behavior - search results are deduplicated so you see only one print per card. Perfect for gameplay-focused searches where you care about unique cards rather than specific prints.

/v0/cards/search?q=elsa&unique=cards

unique=prints

Returns all matching prints without deduplication. Ideal for collectors who want to see all available prints and variants of matching cards.

/v0/cards/search?q=elsa&unique=prints

Examples

Find all Elsa cards (deduplicated):

/v0/cards/search?q=elsa

Find all Elsa prints (all variants):

/v0/cards/search?q=elsa&unique=prints

Compare the difference:

  • unique=cards might return 5 unique Elsa cards
  • unique=prints might return 12 total prints across those same 5 cards

Backward Compatibility

This change is fully backward compatible. All existing API calls continue to work exactly as before, with unique=cards being the default behavior.

The API Documentation has been updated with examples and detailed parameter descriptions.