NFL & college football live viewers & fan picks API

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

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

sports

{league}

games

{id}

audience

NFL & college football live viewers & fan picks API

curl --request GET \
  --url https://xquik.com/api/v1/x/sports/{league}/games/{id}/audience

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/sports/{league}/games/{id}/audience', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/sports/{league}/games/{id}/audience"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "league": "<string>",
  "viewers": {
    "count": 123,
    "asOf": "<string>"
  },
  "teamPicks": {
    "total": 123,
    "teams": [
      {}
    ]
  },
  "chat": {
    "available": true,
    "broadcastId": "<string>",
    "opensIn": {}
  },
  "teams": {
    "id": "<string>",
    "name": "<string>",
    "shortName": "<string>",
    "abbreviation": "<string>",
    "alternateId": "<string>",
    "location": "<string>",
    "colors": [
      {}
    ],
    "logos": {},
    "xUserId": "<string>"
  }
}

1 credit per request · All plans from $0.00012/credit · Direct MPP at USD 0.00015 per call · Supports guest paid reads

curl "https://xquik.com/api/v1/x/sports/nfl/games/2055084502741811200/audience" \
  -H "x-api-key: xq_your_api_key_here" | jq

const gameId = "2055084502741811200";
const response = await fetch(`https://xquik.com/api/v1/x/sports/nfl/games/${gameId}/audience`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const audience = await response.json();
if (!response.ok) throw new Error(JSON.stringify(audience));

console.log(`${audience.viewers?.count ?? 0} watching`);
for (const { teamId, count } of audience.teamPicks.teams) {
  console.log(`${audience.teams[teamId]?.name}: ${count} fans`);
}

import requests

game_id = "2055084502741811200"
response = requests.get(
    f"https://xquik.com/api/v1/x/sports/nfl/games/{game_id}/audience",
    headers={"x-api-key": "xq_your_api_key_here"},
)
audience = response.json()
if not response.ok:
    raise RuntimeError(audience)

print((audience["viewers"] or {}).get("count", 0), "watching")
for pick in audience["teamPicks"]["teams"]:
    print(audience["teams"].get(pick["teamId"], {}).get("name"), pick["count"], "fans")

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

string

required

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

string

required

Game ID, a number up to 19 digits, such as 2055084502741811200. List football games returns it as id. Another value gets a free 400 invalid_game_id.

Query parameters

string

Fields to keep in each row, comma-separated, such as id,text,author.username. Use dots for nested fields. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name returns 400 unknown_field with the valid names, before any read. The price stays the same.

string

Fields to drop from each row, comma-separated, such as entities,media. It takes the same names as fields. With fields, it drops from the kept fields.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

string

The game ID from your request.

string

The league from your request, nfl or ncaafb.

object

People watching the game on X at X’s last count. Null before X counts any.

number

How many people watched the game on X.

string

When X counted them, as an ISO 8601 time.

object

How many people on X picked a team to root for.

number

Picks for every team in the game.

object[]

Picks per team. Each has teamId, a key of teams, & count.

object

The game’s live chat on X.

boolean

Whether the chat is open now.

string

X’s ID for the game’s chat room, such as nfl-2055084502741811200.

object

Time left until the chat opens, as days, hours & minutes. Null while it is open & after the game.

object

The game’s teams, keyed by team ID. X sends no short name, alternate ID or X account here, so those are null. Get football scoreboard has them.

string

The team ID that games & players refer to.

string

The team’s full name, such as San Francisco 49ers.

string

The team’s short name.

string

The team’s abbreviation, such as SF.

string

Another ID X keeps for the team. College plays & drives name a side by it.

string

The school or place the team plays for. College schedules & a game’s audience send it.

object[]

The team’s colors. Each has r, g & b, from 0 to 255.

object

The team’s logo links. default is the one X shows. light & dark suit light or dark backgrounds.

string

The user ID of the team’s X account. Pass it to Get user.

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.

{ "error": "unauthenticated" }

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

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

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

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "not_found",
  "message": "Resource not found."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

NFL & college football live viewers & fan picks API

curl --request GET \
  --url https://xquik.com/api/v1/x/sports/{league}/games/{id}/audience

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/sports/{league}/games/{id}/audience', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/sports/{league}/games/{id}/audience"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "league": "<string>",
  "viewers": {
    "count": 123,
    "asOf": "<string>"
  },
  "teamPicks": {
    "total": 123,
    "teams": [
      {}
    ]
  },
  "chat": {
    "available": true,
    "broadcastId": "<string>",
    "opensIn": {}
  },
  "teams": {
    "id": "<string>",
    "name": "<string>",
    "shortName": "<string>",
    "abbreviation": "<string>",
    "alternateId": "<string>",
    "location": "<string>",
    "colors": [
      {}
    ],
    "logos": {},
    "xUserId": "<string>"
  }
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

NFL & college football live viewers & fan picks API

Read who follows a football game

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid game ID

404 Game not found

401 Unauthenticated

402 Payment required

502 X API unavailable

​Read who follows a football game

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid game ID

​404 Game not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

Read who follows a football game

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid game ID

404 Game not found

401 Unauthenticated

402 Payment required

502 X API unavailable