Top tweets API: most liked & viewed posts on X

{
  "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": "DAAHCgABHTK6Vr___-sLAAIAAAATMjEwMTc3MDE4NjE1NjA1Mjk1OQgAAwAAAAIAAA",
  "filtered_count": 0
}

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

tweets

top

Top tweets API: most liked & viewed posts on X

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/top

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/tweets/top"

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

1 credit per tweet · Up to 100 tweets per list · All plans from $0.00012/credit · Supports guest paid reads

curl --get "https://xquik.com/api/v1/x/tweets/top" \
  --data-urlencode "metric=views" \
  --data-urlencode "window=week" \
  --data-urlencode "country=US" \
  -H "x-api-key: xq_your_api_key_here" | jq

const params = new URLSearchParams({ metric: "views", window: "week", country: "US" });
const response = await fetch(`https://xquik.com/api/v1/x/tweets/top?${params}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const body = await response.json();
if (!response.ok) throw new Error(JSON.stringify(body));

for (const tweet of body.tweets) {
  console.log(`@${tweet.author.username}: ${tweet.viewCount} views`);
}

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/tweets/top",
    params={"metric": "views", "window": "week", "country": "US"},
    headers={"x-api-key": "xq_your_api_key_here"},
)
body = response.json()
if not response.ok:
    raise RuntimeError(body)

for tweet in body["tweets"]:
    print(f'@{tweet["author"]["username"]}: {tweet.get("viewCount")} views')

The tweets X ranks highest

Use GET /x/tweets/top to list the tweets X ranks highest by one metric, as x.com’s Inspiration page shows them. Pick the metric and how far back to look. Narrow it to one country or one language, or leave both out for all of X. Pages hold up to 20 tweets. Pass next_cursor as cursor for the next page. The list ends at 100 tweets.

Query parameters

string

default:"likes"

What to rank tweets by: likes, replies, quotes, bookmarks, shares, or views. Singular names work too, such as like.

string

default:"day"

How far back to look: day, week, or month. Also takes 24h, 7d, 30d, daily, weekly, and monthly.

string

Only tweets from one country, as a 2- or 3-letter ISO 3166 code, such as US or USA. Send country or language, not both.

string

Only tweets in one language, as a 2-letter code, such as en. Send country or language, not both.

string

next_cursor from the previous page.

number

default:"20"

Tweets per page, from 1 to 100. Your credits can return fewer.

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 tweets in X’s order, each with its author, text, media, and metrics, as Search tweets returns them.

boolean

true while more tweets follow, up to 100.

string

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

400 Invalid input

{ "error": "invalid_input", "message": "Send country or language, not both." }

The message says which parameter to fix.

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.

Related. Search tweets · Trends · Get tweet

{
  "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": "DAAHCgABHTK6Vr___-sLAAIAAAATMjEwMTc3MDE4NjE1NjA1Mjk1OQgAAwAAAAIAAA",
  "filtered_count": 0
}

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

Top tweets API: most liked & viewed posts on X

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/top

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/tweets/top"

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

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Top tweets API: most liked & viewed posts on X

The tweets X ranks highest

Query parameters

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

402 Payment required

502 X API unavailable

​The tweets X ranks highest

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid input

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

The tweets X ranks highest

Query parameters

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

402 Payment required

502 X API unavailable