GoSportsAPIDocs
Sign InGet API Key
American Football / Play-by-play

Get Play-by-Play

Retrieve every play of a game in order, with down, distance, field position and result.

GET/v1/american-football/play-by-play

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
game_idintegerRequiredGame ID.
quarterintegerOptionalReturn a single quarter (1–4, 5 for overtime).
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Play>
    Plays in order, most recent last.
  • idinteger
    Unique play ID.
  • quarterinteger
    Quarter the play happened in.
  • clockstring
    Game clock at the snap.
  • teamobject
    Team in possession: id and name.
  • downinteger
    Down, 1–4.
  • distanceinteger
    Yards to go for a first down.
  • yard_linestring
    Line of scrimmage.
  • resultstring
    Plain-language result of the play.
  • metaobject
    game_id, page, per_page and total.

Status codes

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