CAcardhedger
Card Search

Search Players

Changed on

Search Card Hedge's canonical player catalog by partial name.

Duplicate player records (e.g. two "LeBron James" records) are folded into one canonical player: player_id is the canonical ID and aliases lists the merged IDs, whose stats are summed. categories lists every category the player appears in; the optional category filter matches any of them. index says whether a player index is available (current, stale, withheld, or none).

Results are ranked by 30-day sales and capped by count.

Example curl:

curl -X POST -H "X-API-Key: your-api-key-here"          -H "Content-Type: application/json"          -d '{"search":"Luka","count":5}'          "https://api.cardhedger.com/v1/cards/player-search"
post/v1/cards/player-search

Request

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

Request body

searchstring required

Player or character name to search for (2-100 characters)

countinteger

Maximum number of players to return (1-100)

categorystring nullable

Only return players in this category (name or slug, e.g. 'Baseball' or 'yu-gi-oh'). A multi-category player matches any of its categories.

Response

Successful Response

countinteger required

Number of players returned

Example response

{
  "count": 1,
  "players": [
    {
      "aliases": [],
      "cards_tracked": 3746,
      "categories": [
        "Basketball",
        "Baseball"
      ],
      "index": {
        "as_of": "2026-09-25",
        "has_index": true,
        "status": "current"
      },
      "name": "Michael Jordan",
      "player_id": "1585495598505x695909526016884700",
      "thirty_day_sales": 20946
    }
  ]
}

Changes

  • 637bcd3b9a98Revision changes
    • breaking

      removed the media type application/json for the response with the status

    • breaking

      response property players/items/cards_tracked list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property players/items/thirty_day_sales list-of-types was widened by adding types null to media type application/json of response 200

    • info

      added the new optional request property

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • f2d0e595be79Revision changes
    • info

      endpoint added