Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/henrymxu/gosports
https://github.com/henrymxu/gosports
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/henrymxu/gosports
- Owner: henrymxu
- License: mit
- Created: 2019-10-31T23:33:46.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-02-07T21:45:31.000Z (almost 5 years ago)
- Last Synced: 2024-06-19T15:05:13.274Z (7 months ago)
- Language: Go
- Size: 31.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# GoSports API Server
## Endpoints
### Schedule
url: `/schedule/{sport}`
- sport: [mlb, nba, nfl, nhl]
parameters:
- date (_Optional_): [yyyy-mm-dd]
returns:
- array of games:
example:
````
{
content: [
{
id: ,
date: <2006-01-02T15:04:05Z07:00>,
status: [Scheduled, Active, Complete],
statusCode: ,
period: ,
time: , //Time remaining in period/quarter, or number of outs in the inning
home: {
teamId: ,
name: ,
abbr: ,
record: ,
score:
},
away: {
teamId: ,
name: ,
abbr: ,
record: ,
score:
},
venue:
}
]
}
````
### Play By Play
url: `/playbyplay/{sport}`
- sport: [mlb, nba, nfl, nhl]
parameters:
- gameId (_Required_):
returns (internal structure changes based on sport):
- base information (diff)
- array of plays (diff)
example:
````
{
game: {
status: {},
home: {},
away: {}
},
players: {
home: [],
away: []
},
plays: [],
metadata: {
state: ,
lastCheck: ,
}
}
````
#### NHL
````
{
game: {
status: {
period: ,
periodTimeRemaining:
},
home: {
name: ,
score: ,
shots:
},
away: {
name: ,
score: ,
shots:
}
},
players: {
home: [
{
id: ,
onIceDuration: ,
name: ,
number: ,
position:
}, ...
],
away: [
{
id: ,
onIceDuration: ,
name: ,
number: ,
position:
}, ...
]
}
plays: [
{
description: ,
typeId:
periodTime:
dateTime:
coordinates: {
x: ,
y:
}
}, ...
],
metadata: {
state: ,
lastCheck: ,
}
}
````
## Official API Documentation
### NHL
Base: https://statsapi.web.nhl.com/api/v1/
- Schedule:
- Endpoint: `schedule`
- Parameters: [expand (schedule.broadcasts, schedule.linescore, schedule.ticket), teamId, date (yyyy-mm-dd), startDate, endDate]
- Example: https://statsapi.web.nhl.com/api/v1/schedule?expand=schedule.broadcasts,schedule.linescore&teamId=30
- Play by Play:
- Endpoint: `game/%d/feed/live`
- Parameters: [gamePk]
- Example: https://statsapi.web.nhl.com/api/v1/game/2019020195/feed/live
- Play by Play Diff:
- Endpoint: `game/%d/feed/live/diffPatch`
- Parameters: [gamePk, startTimecode (yyyymmdd_hhmmss)]
- Example: https://statsapi.web.nhl.com/api/v1/game/2018020150/feed/live/diffPatch?startTimecode=20181027_1600
### NBA
Base: https://stats.nba.com/stats/
BaseV2: http://data.nba.com/data/5s/json/cms/noseason/
- Schedule:
- Endpoint: `scoreboardv2`
- Parameters: [GameDate (yyyy-mm-dd), LeagueID, DayOffset]
- Example: https://stats.nba.com/stats/scoreboardv2/?GameDate=2019-10-31&LeagueID=00&DayOffset=0
- Play by Play:
- Endpoint: `playbyplayv2`
- Parameters: [GameID, StartPeriod (1 - 4), EndPeriod]
- Example: https://stats.nba.com/stats/playbyplayv2/?GameID=0021900054&StartPeriod=1&EndPeriod=4
- ScheduleV2:
- Endpoint: `scoreboard/%s/games.json`
- Parameters: [Date (yyyymmdd)]
- Example: http://data.nba.com/data/5s/json/cms/noseason/scoreboard/20191120/games.json
- Play by Play V2:
- Endpoint: `game/%s/%s/pbp_all.json`
- Parameters: [Date (yyyymmmdd), GameID]
- Example: http://data.nba.com/data/5s/json/cms/noseason/game/20191118/0021900189/pbp_all.json
### NFL
Base: https://www.nfl.com/
- Schedule:
- Endpoint: `ajax/scorestrip` && `feeds-rs/currentWeek.json`
- Parameters: [season (yyyy), seasonType (PRE, REG, POST), week]
- Example: https://www.nfl.com/ajax/scorestrip/?season=2019&seasonType=REG&week=9 && https://www.nfl.com/feeds-rs/currentWeek.json
- Play by Play:
- Endpoint: `liveupdate/game-center/%s/%s_gtd.json`
- Parameters: [eid, eid]
- Example: https://www.nfl.com/liveupdate/game-center/2019103100/2019103100_gtd.json
### MLB
Base: https://statsapi.mlb.com/api/v1.1/
- Schedule (API v1):
- Endpoint: `schedule`
- Parameters: [scheduleType, eventTypes, hydrate (decisions, probablePitcher(note), linescore), teamId, leagueId, sportId, gamePk, gamePks, venueIds, gameTypes, date (yyyy-mm-dd), startDate, endDate, opponentId, fields]
- Example: http://statsapi.mlb.com/api/v1/schedule/?sportId=1&date=2019-10-30&hydrate=team
- Play by Play (API v1.1):
- Endpoint: `game/%s/feed/live`
- Parameters: [gamePk]
- Example: https://statsapi.mlb.com/api/v1.1/game/599377/feed/live