Sports

Get a game's audience

Changed on

Returns who follows 1 game on X. It has live viewers, fan picks per team & the game chat's state. Each request costs 1 credit.

get/x/sports/{league}/games/{id}/audience

Request

  • Base URL: https://xquik.com/api/v1
  • URL: https://xquik.com/api/v1/x/sports/{league}/games/{id}/audience
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer
    • none

Path parameters

league'nfl' | 'ncaafb' required
Example:nfl

nfl for the NFL or ncaafb for college football, in any case. Another value gets a free 400 invalid_league before X is read.

idstring required
Example:2055084502741811200

Game ID, a number up to 19 digits. GET /x/sports/{league}/games lists them. Another value gets a free 400 invalid_game_id before X is read.

Query parameters

fieldsstring
Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring
Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

The game's audience

idstring required

The ID of the game, from your request.

league'nfl' | 'ncaafb' required

The game's league, from your request.

teamsobject required

The game's teams, by team ID. X's team picker sends no short name, alternate ID, X account or record, so those are null.

Example response

{
  "id": "2055084502741811200",
  "league": "nfl",
  "viewers": {
    "count": 155,
    "asOf": "2026-10-20T06:19:50.000Z"
  },
  "teamPicks": {
    "total": 7976,
    "teams": [
      {
        "teamId": "689566294702555136",
        "count": 4998
      },
      {
        "teamId": "689566304366292992",
        "count": 2978
      }
    ]
  },
  "chat": {
    "available": false,
    "broadcastId": "nfl-2055084502741811200",
    "opensIn": null
  },
  "teams": {}
}

Changes

  • e29bc136a9ccRevision changes
    • breaking

      the response property const value changed from /dashboard/account to /dashboard/billing for the status

    • breaking

      the response property const value changed from /dashboard/account to /dashboard/billing for the status

    • breaking

      the response property const value changed from /dashboard/account to /dashboard/billing for the status

    • breaking

      the response property const value changed from Ask the user to top up at /dashboard/account. This key cannot open checkout. to Ask the user to top up at /dashboard/billing. This key cannot open checkout. for the status

  • 4b2932bda17aRevision changes
    • info

      endpoint added