Skip to main content
GET https://xquik.com/api/v1/x/sports/{league}/games/{id}/posts
1 credit per post · Up to 20 posts per pageAll plans from $0.00012/credit · Supports guest paid reads

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 (Twitter) search that finds the posts. X builds it from the teams, hashtags, team accounts & star players. X adds the game’s time window.
Pass query to Search tweets to add filters like language, media or minimum likes. A game has posts before kickoff, during the game & after it.

Path parameters

Query parameters

Choose fields

Headers

Response

200 OK

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.

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.

503 Service busy

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.

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required." }
  • 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." }