CAcardhedger
Card Search

Search Cards

Search for cards with flexible filtering options.

Searches CardHedge database with optional filters for search query, set, category, player, card number, subset, and rookie status. Supports pagination to iterate through large result sets.

Response includes:

  • pages: Total number of pages available
  • count: Total number of matching cards
  • cards: Array of card objects for the current page

Example curl:

curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "search": "Shohei Ohtani",
       "category": "Baseball",
       "page": 1,
       "page_size": 20
     }' \
     "https://api.cardhedger.com/v1/cards/card-search"

Returns matching cards with pricing, sales data, and pagination metadata.

post/v1/cards/card-search

Request

  • Base URL
    https://api.cardhedger.com
  • Auth
    API key in header X-API-Key

Request body

searchstring nullable

Search query for card name/description

setstring nullable

Filter by set name (e.g., '2025 Topps Baseball')

categorystring nullable

Filter by category (e.g., 'Baseball', 'Basketball')

playerstring nullable

Filter by player name

numberstring nullable

Filter by card number within the set (exact match, e.g. '150')

subsetstring nullable

Filter by subset within the set (exact match, e.g. 'Base Set', 'Chrome')

rookiestring nullable

Filter by rookie status (e.g., 'Rookie')

pageinteger

Page number for pagination

page_sizeinteger

Number of results per page (1-100)

raw_images_onlyboolean nullable

Image preference. Omitted (default): return the raw card photo, falling back to the graded slab image only when no raw photo exists. true: force raw-only (no graded fallback). false: prefer the graded slab image.

Response

Successful Response

pagesinteger

Total number of pages available

countinteger

Total number of matching cards

count_cappedboolean

True when count is a capped value and the real total is higher (filter-only browses cap the count for performance). Render as count+ — e.g. "10,000+".

Example response

{
  "cards": [
    {
      "30 Day Sales": 187,
      "7 Day Sales": 45,
      "card_id": "1587446850514x224832321163624450",
      "category": "Baseball",
      "category_group": "Sports Cards",
      "description": "Shohei Ohtani 2018 Topps Chrome Baseball",
      "gain": 2.5,
      "image": "//s3.amazonaws.com/appforest_uf/example.jpg",
      "number": "150",
      "player": "Shohei Ohtani",
      "prices": [
        {
          "grade": "PSA 10",
          "price": "850"
        },
        {
          "grade": "PSA 9",
          "price": "125"
        },
        {
          "grade": "Raw",
          "price": "45.99"
        }
      ],
      "rookie": true,
      "set": "2018 Topps Chrome Baseball",
      "set_type": "Topps Chrome Baseball",
      "variant": "Base"
    }
  ],
  "count": 742,
  "pages": 15
}

Changes

No recorded changes to this operation across all 14 revisions of this API.