logologo
WIDGETSAPIPRICINGCOVERAGESUPPORT

Football API Tech Docs

Question & Answers

Tech Docs Index

  • Documentation
    • Main Page
  • Widgets
    • Widget Tech Docs
  • Lookups
    • Languages
    • Soccer Match Events Lookup
    • API Error Codes
    • Widget Error Codes
  • Global API
    • Sports List
    • Country List
    • Round List
    • Status List
  • Soccer API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Leaderboard: Goals
    • Leaderboard: Assists
    • Leaderboard: Yellow Cards
    • Leaderboard: Red Cards
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Missing Players List
    • Match Summary
    • Match Lineup
    • Match Statistics
    • Match Commentary
    • Match Events Basic
    • Match Events All
    • Team Squad
    • Team Squad with Statistics
    • Team Schedule
    • Recent Match List
    • Result Statistics
    • Referee Statistics
    • Team Streaks
    • Goal Analysis: Goal Minutes in Between
    • Goal Analysis: Scoring First in Between
    • Seasonal Goal Analysis: Scoring First
    • Seasonal Goal Analysis: Conceding First
    • Seasonal Goal Analysis: Goal Minutes
    • Seasonal Goal Analysis: Goal Conceded Minutes
    • Market Tables: Under/Over
    • Market Tables: Both Teams to Score
    • Market Tables: Total Goals
    • Seasonal Statistics: Goals
    • Seasonal Market Statistics: Goals
    • Market Statistics: Goals
  • Basketball API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Leaderboard: Points
    • Leaderboard: Assists
    • Leaderboard: Rebounds
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Match Summary
    • Match Boxscore
    • Match Statistics
    • Match Play by Play
    • Match Game Leaders
    • Team Squad
    • Team Schedule
    • Recent Match List
    • Result Statistics
    • Market Statistics (Points)
    • Quarter Analysis
    • Seasonal Advanced Team Statistics
    • Under / Over Analysis
    • Seasonal Statistics: Points
    • Seasonal Market Statistics: Points
    • Seasonal Statistics: Quarter Analysis
    • Match Margins
  • Football API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Match Boxscore
    • Match Game Leaders
    • Match Team Statistics
    • Match Key Statistics
    • Match Play by Play
  • Baseball API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
  • Ice Hockey API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Recent Match List
  • Volleyball API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Team Schedule
    • Recent Match List
    • Result Statistics: Points
    • Seasonal Statistics: Points
  • Handball API
    • Tournament List
    • Tournament Info
    • Tournament Teams
    • Tournament Fixture
    • Tournament Standings
    • Match List: All
    • Match List: Scheduled
    • Match List: Live
    • Match List: Results
    • Team Schedule
    • Recent Match List
    • Result Statistics: Goals
    • Seasonal Statistics: Goals

Football API Play-by-Play

Provides all match drives and plays during the match with their detailed informations.

Football Play by Play Request URL

GET

References / Dependencies

 Tournament ID  The id of the tournament. You can find list of the tournament from Tournament List endpoint 
 Stage / Round Structure  Stage / Round structures change tournament by tournament. You can find the structures with Tournament Id from Tournament Info endpoint 
 Matches from Fixture  Match Ids can be retrieved from The fixture of the tournament. You can find all matches of the tournament from Tournament Fixture endpoint 
 Matches from Match List  Match Ids can be retrieved from The Daily Match List. You can find all matches in 7-days period from Match List endpoint 

Call Rate / Interval

Recommended API Call Interval at live: 12 Request / Minute  Recommended API Call Interval at 1 hour after game end: 1 Request / Minute Recommended API Call Interval at more than 1 hour after game end: 4 Request / Hour 

Request Headers

DataTypeO / RExampleDescription
languageIdINTR{languageId}The id of the language that you select.
Ocp-Apim-Subscription-KeySTR
R{yourOcp-Apim-Subscription-Key}Your account key.
AcceptSTROapplication/xmlSelection of data presentation type as XML/JSON.
 *O= Optional, R= Required

Request Parameters

DataTypeO / RExampleDescription
matchIdINTR{matchId}The id of the match

Response Output

Response Output Definitions

match

DataTypeExampleDescription
idINT18656The id of the match
dateDATE/STR03/02/2019 23:30:00The date of the match
tournament
DataTypeExampleDescription
nameSTRNational Football LeagueThe name of the tournament
shortNameSTRNFLThe short name of the tournament
idINT1The id of the tournament
stage
DataTypeExampleDescription
nameSTRSuper BowlThe name of the stage
shortNameSTRSBThe short name of the stage
idINT726The id of the stage
round
DataTypeExampleDescription
nameSTRSingle GameThe name of the round
shortNameSTRSGThe short name of the round
idINT209The id of the round
homeTeam/awayTeam
DataTypeExampleDescription
nameSTRNew England PatriotsThe name of the home/away team for the match
mediumNameSTRPatriotsThe short name of the home/away team for the match
shortNameSTRNEThe short name of the home/away for the match
idINT5The id of the home/away for the match
drives
DataTypeExampleDescription
idINT19228Id of the drive
periodINT15Status Id of the drive
startTimeSTR01:12Starting game clock of the drive
yardsGainedINT55Total gained yards for the drive
totalFirstDownsINT2Total gained yards for the drive
durationSTR1:07Total duration of the drive
team
DataTypeExampleDescription
nameSTRLos Angeles RamsName of the drive’s team
shortNameSTRLARShort name of the drive’s team
idINT31Id of the drive’s team
plays
DataTypeExampleDescription
quarterINT4period of the play
timeSTR01:12starting game clock of the play
downINT1down order of the play
yardsToGoINT10The remaining yard value to the next down
startYardTeamShortNameSTRLARStart line's team short name of the play
startYardLineINT25Start line's yard of the play
commentaryTextSTR(00:21) Jared Goff pass to Brandin Cooks to NE 30 for 21 yards (Jonathan Jones).Commentary text of the play
2019 - Broadage Sports All rights reserved