NFL & college football game posts API, top or latest

{
  "tweets": [
    {
      "id": "2102761519985332442",
      "text": "This galaxy is a little extra.\n\nMeet Messier 106, a spiral galaxy with an extra set of arms. These two additional arms are made of gas heated up by jets from the galaxy’s central black hole. The jets’ superheated shockwaves are depicted in royal blue by @chandraxray. https://t.co/421Lzs0r0c",
      "retweetCount": 1364,
      "replyCount": 271,
      "likeCount": 9775
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACHVOxUHMAJxAKAAMdU7FQcv_Y8AgABAAAAAILAAUAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRZFVMTzZONXZBcWgxUTBKTlBXeERDSFZDN3g5QVd3SThkVVhQNHN0ZXdKaDFRcGJ5Zm1uQnpIVkNuT040YnNIVWRVTUcxMUZaaGVSMVJTek56VnVBbEhWQzR5NEFhNGVZZFVMTDVZOXNCckIxUXJmN0NtMUZCSFZDeCt2ZWFNTEFkVUtSRkF4b2dsaDFRbVJETUY3QmNIVkNJNGpjV0lLa2RVVW15QTFkUlh4MVJHclhDVjJIdEhWQ3lGeWthUU1FZFVMSmlFOW9BVEIxUmxiS1gxdEZCCAAGAAAAAAgABwAAAAAMAAgKAAEdUIjiNxYgqQAAAA",
  "query": "(#WASvsSF OR #WASatSF OR \"San Francisco 49ers\" OR \"Washington Commanders\" OR @49ers OR @Commanders) since_time:1792455300 until_time:1792541700 -filter:nativeretweets"
}

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

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

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

posts

NFL & college football game posts API, top or latest

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

const options = {method: 'GET'};

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

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

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

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

	fmt.Println(string(body))

}

{
  "tweets": [
    {}
  ],
  "has_next_page": true,
  "next_cursor": "<string>",
  "query": {}
}

1 credit per post · Up to 20 posts per page · All plans from $0.00012/credit · Supports guest paid reads

curl "https://xquik.com/api/v1/x/sports/nfl/games/2055084502741811200/posts?queryType=Top" \
  -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}/posts?queryType=Top`,
  { headers: { "x-api-key": "xq_your_api_key_here" } },
);
const page = await response.json();
if (!response.ok) throw new Error(JSON.stringify(page));

for (const tweet of page.tweets) {
  console.log(`@${tweet.author.username}: ${tweet.likeCount} likes`);
}

import requests

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

for tweet in page["tweets"]:
    print(f"@{tweet['author']['username']}: {tweet['likeCount']} likes")

Read what X shows about a game

Use GET /x/sports/{league}/games/{id}/posts for the posts on a game’s page on X. Find the game ID with List football games.

queryType=Top returns the posts X ranks highest. queryType=Latest returns the newest first.
Each post has the same fields as Search tweets returns.
query is the X search that finds the posts. X builds it from the teams, hashtags, team accounts & star players, with the game’s time window.

Pass query to Search tweets to add filters such as language, media or minimum likes. A game has posts before kickoff, during the game & after it.

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

default:"Top"

Top for the posts X ranks highest or Latest for the newest, in any case. Relevance & Recency work too, & so do the names order & sort. Send the same value with each cursor.

string

next_cursor from the previous page.

number

default:"20"

Posts per page, from 1 to 100. X sends at most 20 per page, & your credits can return fewer.

Choose fields

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

object[]

The posts in X’s order, each with its author, text, media & metrics, as Search tweets returns them.

boolean

true while more posts follow.

string

Pass it as cursor for the next page. Empty on the last page.

string | null

The X search that finds this game’s posts for the order you asked. null when X sends a timeline Xquik cannot read.

400 Invalid input

{ "error": "invalid_params", "message": "Unknown queryType. Use Latest or Top." }

queryType is not Top, Latest, Relevance or Recency. A league other than nfl or ncaafb gets invalid_league, & a game ID that is not a number gets invalid_game_id. These 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. 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.

503 Service busy

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

Xquik is busy, or X sent an answer Xquik cannot read. Wait for the Retry-After header, then send the request again. The request costs nothing.

{
  "tweets": [
    {
      "id": "2102761519985332442",
      "text": "This galaxy is a little extra.\n\nMeet Messier 106, a spiral galaxy with an extra set of arms. These two additional arms are made of gas heated up by jets from the galaxy’s central black hole. The jets’ superheated shockwaves are depicted in royal blue by @chandraxray. https://t.co/421Lzs0r0c",
      "retweetCount": 1364,
      "replyCount": 271,
      "likeCount": 9775
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACHVOxUHMAJxAKAAMdU7FQcv_Y8AgABAAAAAILAAUAAADwRW1QQzZ3QUFBZlEvZ0dKTjB2R3AvQUFBQUJRZFVMTzZONXZBcWgxUTBKTlBXeERDSFZDN3g5QVd3SThkVVhQNHN0ZXdKaDFRcGJ5Zm1uQnpIVkNuT040YnNIVWRVTUcxMUZaaGVSMVJTek56VnVBbEhWQzR5NEFhNGVZZFVMTDVZOXNCckIxUXJmN0NtMUZCSFZDeCt2ZWFNTEFkVUtSRkF4b2dsaDFRbVJETUY3QmNIVkNJNGpjV0lLa2RVVW15QTFkUlh4MVJHclhDVjJIdEhWQ3lGeWthUU1FZFVMSmlFOW9BVEIxUmxiS1gxdEZCCAAGAAAAAAgABwAAAAAMAAgKAAEdUIjiNxYgqQAAAA",
  "query": "(#WASvsSF OR #WASatSF OR \"San Francisco 49ers\" OR \"Washington Commanders\" OR @49ers OR @Commanders) since_time:1792455300 until_time:1792541700 -filter:nativeretweets"
}

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

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "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 game posts API, top or latest

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

const options = {method: 'GET'};

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

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

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

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

	fmt.Println(string(body))

}

{
  "tweets": [
    {}
  ],
  "has_next_page": true,
  "next_cursor": "<string>",
  "query": {}
}

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 game posts API, top or latest

Read what X shows about a game

Path parameters

Query parameters

Choose fields

Headers

Response

200 OK

400 Invalid input

404 Game not found

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

​Read what X shows about a game

​Path parameters

​Query parameters

​Choose fields

​Headers

​Response

​200 OK

​400 Invalid input

​404 Game not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​503 Service busy

Read what X shows about a game

Path parameters

Query parameters

Choose fields

Headers

Response

200 OK

400 Invalid input

404 Game not found

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy