Skip to main content
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

Use GET /x/sports/{league}/games/{id}/plays for a game’s full play-by-play. Find the game ID with List football games.
  • quarters lists each quarter in order. Each quarter lists its drives, and each drive its plays.
  • 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.
  • details lists each step of a play, with its players, yards & any penalty.
  • post is the post X links to the play. videoPostId & videoReplyPostId point to its video.
Each player appears once in 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 get WWW-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." }