GET games/summary

Description

Returns a summary of games that meet the search criteria.

Resource URL

http://clutchwin.com/api/v1/games/summary.json

Parameters

Field Default Description

start_date

required
Specifies the beginning of the time period for which games should be returned. Format: YYYY-MM-DD

end_date

required
Specifies the end of the time period for which games should be returned Format: YYYY-MM-DD

game_type

optional
regular Filters the list for a particular type of game (regular, all-star, or post-season). Valid values: asg, dv, lc, wc, ws, regular.

day_of_week

optional
Return only games played on the specified day of the week Valid values: mon, tue, wed, thu, fri, sat, sun.

visiting_team

optional
Return only games where the specified team is the visiting team.

home_team

optional
Return only games where the specified team is the home team.

park_id

optional
Return only games played in the specified ballpark.

include

optional
To include the events for a game, specify include=events.

group

optional
Specify a field (or list of fields) in the games table to group the results by that field. For example, specify 'season' to get a summary of a game records for each year. For more than one field, separate the entries with a comma.

Example Requests

Return a statistical summary of Orioles 1969 regular season home games.

GET

http://clutchwin.com/api/v1/games/summary.json?start_date=1969-01-01&end_date=1969-12-31&home_team=BAL&access_token=[token]

Response:

[
  {
    "g": 81,
    "visitor_score": 251,
    "home_score": 402,
    "attendance": 1012368,
    "time_of_game": 12060,
    "visitor_ab": 2729,
    "visitor_h": 596,
    "visitor_2b": 86,
    "visitor_3b": 9,
    "visitor_hr": 51,
    "visitor_rbi": 237,
    "visitor_sh": 28,
    "visitor_sf": 20,
    "visitor_hbp": 10,
    "visitor_bb": 229,
    "visitor_ibb": 25,
    "visitor_k": 450,
    "visitor_sb": 29,
    "visitor_cs": 27,
    "visitor_gidp": 59,
    "visitor_ci": 0,
    "visitor_lob": 503,
    "visitor_pitchers_used": 250,
    "visitor_ind_er": 350,
    "visitor_team_er": 348,
    "visitor_wp": 26,
    "visitor_balks": 2,
    "visitor_putouts": 2099,
    "visitor_a": 835,
    "visitor_e": 69,
    "visitor_pb": 8,
    "visitor_dp": 76,
    "visitor_tp": 0,
    "home_ab": 2683,
    "home_h": 723,
    "home_2b": 129,
    "home_3b": 14,
    "home_hr": 82,
    "home_rbi": 379,
    "home_sh": 37,
    "home_sf": 31,
    "home_hbp": 25,
    "home_bb": 321,
    "home_ibb": 36,
    "home_k": 362,
    "home_sb": 35,
    "home_cs": 20,
    "home_gidp": 68,
    "home_ci": 0,
    "home_lob": 596,
    "home_pitchers_used": 194,
    "home_ind_er": 223,
    "home_team_er": 222,
    "home_wp": 16,
    "home_balks": 3,
    "home_putouts": 2262,
    "home_a": 893,
    "home_e": 51,
    "home_pb": 7,
    "home_dp": 70,
    "home_tp": 1
  }
]
              

Resource Information

Rate Limited? No
Requests per rate limit window N/A
Response Formats json, xml
HTTP Methods GET
Resource family games
API Version API v1.0