Skip to main content
GET https://xquik.com/api/v1/x/sports/{league}/games/{id}/audience
1 credit per request · All plans from $0.00012/creditDirect MPP at USD 0.00015 per call · Supports guest paid reads

Read who follows a football game

Use GET /x/sports/{league}/games/{id}/audience for the crowd around 1 game on X. Find the game ID with List football games. Call it again to follow a live game.
  • viewers has how many people watched the game on X & when X counted them.
  • teamPicks has how many people picked each team to root for.
  • chat says whether the game chat is open, or how long until it opens.
  • teams holds each team once, keyed by ID, with its location.
viewers is null until X counts any viewers, as before kickoff. Each teamId is a key of teams.

Path parameters

Query parameters

Headers

Response

200 OK

Each value in teams 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." }