Basic lookup

Search players

Use when looking up a player by name. Searches 4,900+ players across every season since 2010-11. Returns active players by default; set active=false for retired/historical. Use the returned player ID with get_player_stats for full details. Costs 2 credits.

post/v1/search_players

Request

  • Base URL: https://mcp.puckapi.com
  • URL: https://mcp.puckapi.com/v1/search_players
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

querystring required

Player name to search for (partial match supported)

teamstring

Filter by team abbreviation

position'G' | 'D' | 'C' | 'LW' | 'RW'

Filter by position

activeboolean

Filter by active status (default: true). Set false to search active plus retired/historical players.

limitinteger

Max results (default 10)

league'nhl' | 'pwhl' | 'ohl' | 'whl' | 'qmjhl' | 'echl' | 'ahl' | 'ushl'

League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl.

Response

The result, wrapped in data.

Changes

No recorded changes to this operation across all 1 revision of this API.