GET https://xquik.com/api/v1/x/sports/{league}/games/{id}/plays
1 credit per request · All plans from $0.00012/creditDirect MPP at USD 0.00015 per call · Supports guest paid reads
Read every drive & play of a game
UseGET /x/sports/{league}/games/{id}/plays for a game’s full play-by-play. Find the game ID with
List football games.quarterslists each quarter in order. Each quarter lists itsdrives, and each drive itsplays.- A drive has its clock, first downs & net yards. It also says how it started & ended.
- A play has its clock, down & distance, description & the score after it.
detailslists each step of a play, with its players, yards & any penalty.postis the post X links to the play.videoPostId&videoReplyPostIdpoint to its video.
players, keyed by ID. Steps name players by playerId, with a
playerRole such as Pass or Tackle. Pass a post ID to Get tweet
to read it.
A whole game fits 1 response, so there are no pages. quarters is empty before kickoff.
NFL games name a side as Home or Away in offense, defense, possession & yardlineSide.
College games name it by the team’s alternateId from teams.Path parameters
Query parameters
Headers
Response
200 OK
Each item in
quarters[].drives[].plays has these fields.Each value in
teams has these fields.Each value in
players has these fields.400 Invalid game ID
{ "error": "invalid_game_id", "message": "Send a numeric game ID, such as 2055084502741811200." }
The game ID is not a number. A league other than nfl or ncaafb gets invalid_league. Both
answers are free.404 Game not found
{ "error": "game_not_found", "message": "Game not found. Find game IDs with GET /x/sports/nfl/games." }
X knows no game with this ID in the league. This answer is free.401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.402 Payment required
Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.502 X API unavailable
The read service returned an error. Retry after a short delay.Response examples
200 example
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "not_found", "message": "Resource not found." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }