Hockey / Players

Get Players

Retrieve skater and goalie profiles with position, current team and season statistics, sortable for leaderboards.

GET/v1/hockey/players

Parameters

NameTypeRequiredDescription

x-api-keystringRequiredYour API key, sent as a header.

idintegerOptionalFilter by player ID.

team_idintegerOptionalFilter by team ID.

league_idintegerOptionalFilter by league ID.

seasonintegerOptionalSeason start year for the statistics.

sortstringOptionalgoals, assists or points, highest first.

pageintegerOptionalPage number. Default 1, 50 per page.

Response

dataarray<Player>
Players matching your filters.
idinteger
Unique player ID.
namestring
Player name.
positionstring
C, LW, RW, D or G.
teamobject
Current team: id and name.
statsobject
games, goals, assists and points for the season.
metaobject
page, per_page and total.

Status codes

200Players returned
400Invalid parameter
401Missing or invalid API key
429Rate limit reached

Try it out

1curl -G "https://api.gosportsapi.com/v1/hockey/players" \
2  -H "x-api-key: YOUR_API_KEY" \
3  -d league_id=57 \
4  -d sort=points

200 OKapplication/json

1{
2  "data": [
3    {
4      "id": 8478402,
5      "name": "Connor McDavid",
6      "position": "C",
7      "team": { "id": 22, "name": "Edmonton Oilers" },
8      "stats": { "games": 10, "goals": 4, "assists": 9, "points": 13 }
9    }
10  ],
11  "meta": { "page": 1, "per_page": 50, "total": 812 }
12}

API Information

Data freshness: ~30 seconds
Recommended polling: 60 seconds
Request cost: 1 request
Required plan: [Plan]+