NFL & college football box score & player stats API

{
  "id": "2055084502741811200",
  "league": "nfl",
  "home": {
    "teamId": "689566294702555136",
    "totals": null,
    "players": []
  },
  "away": {
    "teamId": "689566304366292992",
    "totals": null,
    "players": []
  },
  "teams": {},
  "players": {}
}

{
  "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}

box-score

NFL & college football box score & player stats API

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

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/sports/{league}/games/{id}/box-score', 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}/box-score"

	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>",
  "home": {
    "teamId": "<string>",
    "totals": {
      "firstDowns": 123,
      "thirdDowns": {},
      "fumbles": {},
      "passing": {},
      "penalties": {},
      "rushing": {},
      "timeOfPossessionSeconds": 123,
      "totalYards": 123,
      "turnovers": 123
    },
    "players": [
      {
        "playerId": "<string>",
        "passing": {},
        "rushing": {},
        "receiving": {},
        "defense": {},
        "fumbles": {},
        "kickReturns": {},
        "puntReturns": {},
        "interceptionReturns": {},
        "punts": {},
        "fieldGoals": {},
        "extraPoints": {},
        "conversions": {}
      }
    ]
  },
  "away": {},
  "teams": {
    "id": "<string>",
    "name": "<string>",
    "shortName": "<string>",
    "abbreviation": "<string>",
    "alternateId": "<string>",
    "location": "<string>",
    "colors": [
      {}
    ],
    "logos": {},
    "xUserId": "<string>"
  },
  "players": {
    "id": "<string>",
    "teamId": "<string>",
    "name": "<string>",
    "shortName": "<string>",
    "jersey": "<string>",
    "position": "<string>",
    "college": "<string>",
    "birthPlace": "<string>",
    "birthDate": "<string>",
    "headshots": {},
    "xUser": {}
  }
}

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/box-score" \
  -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}/box-score`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const game = await response.json();
if (!response.ok) throw new Error(JSON.stringify(game));

for (const side of [game.home, game.away]) {
  for (const entry of side.players) {
    if (entry.passing === undefined) continue;
    const player = game.players[entry.playerId];
    console.log(`${player?.name} ${entry.passing.completions}/${entry.passing.attempts}`);
  }
}

import requests

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

for side in (game["home"], game["away"]):
    for entry in side["players"]:
        passing = entry.get("passing")
        if passing is None:
            continue
        player = game["players"].get(entry["playerId"], {})
        print(player.get("name"), f"{passing['completions']}/{passing['attempts']}")

Read team totals & player stats

Use GET /x/sports/{league}/games/{id}/box-score for a game’s stats. Find the game ID with List football games.

home & away hold each team’s totals & a players list.
totals has first downs, third downs, passing, rushing, penalties, turnovers & time of possession.
Each players entry has a playerId & the stat groups X sent for that player.
players at the top holds each player once, keyed by ID, with name, position & photos.

A stat group X did not send is left out, so a kicker has no passing. A game that has not started has no stats yet, so totals is null.

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

The home team’s totals & player stats.

string

The team, a key of teams.

object

The team’s totals, or null before kickoff.

number

First downs.

object

Third downs tried in attempts & converted in successes.

object

The team’s fumbles, with the fields of a player’s fumbles.

object

The team’s passing, with the fields of a player’s passing.

object

Penalties against the team, as count & yards.

object

The team’s rushing, with the fields of a player’s rushing.

number

Time with the ball, in seconds.

number

Total yards.

number

Turnovers.

object[]

Each player with stats, 1 entry per player. Only the stat groups X sent are present.

string

The player, a key of players.

object

attempts, completions, yards, netYards after sacks, avgYards, touchdowns, interceptions, sacks, sackYards & the passer rating.

object

attempts, yards, avgYards, longest & touchdowns.

object

targets, receptions, yards, avgYards per catch, longest & touchdowns.

object

tackles solo, combined solo & assisted, tacklesForLoss, sacks with a shared sack as 0.5, interceptions, passesDefended & forcedFumbles.

object

lost to the other team, ownRecoveryTouchdowns & opponentRecoveryTouchdowns.

object

returns, yards, avgYards, longest & touchdowns.

object

Punt returns, with the fields of kickReturns.

object

Interception returns, with the fields of kickReturns.

object

attempts, yards, avgYards, avgNetYards after returns, inside20 & longest.

object

attempts, made & the longest made, in yards.

object

Extra point kicks, as attempts & made.

object

2-point conversions by passSuccesses, rushSuccesses, turnoverSuccesses & defenseSuccesses.

object

The away team’s totals & player stats, with the fields of home.

object

The teams this answer names, keyed by team ID.

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 a college team plays for. X sends it only in college schedules.

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.

object

The players this answer names, keyed by player ID.

string

The player ID that plays & stats refer to.

string

The player’s team, a key of teams.

string

The player’s full name.

string

The name play descriptions use, such as B.Purdy.

string

The jersey number, as text.

string

The position, such as QB or DE.

string

The college the player came from.

string

Where the player was born.

string

The birth date, as YYYY-MM-DD.

object

Photo links in original, large, medium & small. Any of them can be null.

object

The player’s X account, with id, username & blueVerified. Null when the player has none.

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",
  "home": {
    "teamId": "689566294702555136",
    "totals": null,
    "players": []
  },
  "away": {
    "teamId": "689566304366292992",
    "totals": null,
    "players": []
  },
  "teams": {},
  "players": {}
}

{
  "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 box score & player stats API

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

const options = {method: 'GET'};

fetch('https://xquik.com/api/v1/x/sports/{league}/games/{id}/box-score', 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}/box-score"

	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>",
  "home": {
    "teamId": "<string>",
    "totals": {
      "firstDowns": 123,
      "thirdDowns": {},
      "fumbles": {},
      "passing": {},
      "penalties": {},
      "rushing": {},
      "timeOfPossessionSeconds": 123,
      "totalYards": 123,
      "turnovers": 123
    },
    "players": [
      {
        "playerId": "<string>",
        "passing": {},
        "rushing": {},
        "receiving": {},
        "defense": {},
        "fumbles": {},
        "kickReturns": {},
        "puntReturns": {},
        "interceptionReturns": {},
        "punts": {},
        "fieldGoals": {},
        "extraPoints": {},
        "conversions": {}
      }
    ]
  },
  "away": {},
  "teams": {
    "id": "<string>",
    "name": "<string>",
    "shortName": "<string>",
    "abbreviation": "<string>",
    "alternateId": "<string>",
    "location": "<string>",
    "colors": [
      {}
    ],
    "logos": {},
    "xUserId": "<string>"
  },
  "players": {
    "id": "<string>",
    "teamId": "<string>",
    "name": "<string>",
    "shortName": "<string>",
    "jersey": "<string>",
    "position": "<string>",
    "college": "<string>",
    "birthPlace": "<string>",
    "birthDate": "<string>",
    "headshots": {},
    "xUser": {}
  }
}

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 box score & player stats API

Read team totals & player stats

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 team totals & player stats

​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 team totals & player stats

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