Tweet engagement API: velocity & reach on X

{
  "insights": {
    "tweetId": "2102882545427714266",
    "authorId": "11348282",
    "authorUserName": "NASA",
    "createdAt": "2026-09-23T22:07:23.000Z",
    "ageHours": 133.88
  }
}

{
  "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": "tweet_not_found",
  "message": "Tweet not found. Check the tweet ID."
}

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

{id}

insights

Tweet engagement API: velocity & reach on X

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}/insights

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}/insights"

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

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

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

	fmt.Println(string(body))

}

{
  "insights": {
    "tweetId": "<string>",
    "authorId": {},
    "authorUserName": {},
    "createdAt": {},
    "ageHours": {},
    "metrics": {},
    "engagements": 123,
    "engagementsPerHour": {},
    "engagementPerView": {},
    "engagementRate": {},
    "amplification": {},
    "conversation": {}
  }
}

1 credit per report, whatever it reads · A tweet X doesn’t have is free · All plans from $0.00012/credit · Supports guest paid reads

curl "https://xquik.com/api/v1/x/tweets/2102882545427714266/insights" \
  -H "x-api-key: xq_your_api_key_here" | jq

const response = await fetch("https://xquik.com/api/v1/x/tweets/2102882545427714266/insights", {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const body = await response.json();
if (!response.ok) throw new Error(JSON.stringify(body));

const { insights } = body;
console.log(
  `${insights.engagementsPerHour} engagements an hour, ${insights.engagementPerView}% of views`,
);

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/tweets/2102882545427714266/insights",
    headers={"x-api-key": "xq_your_api_key_here"},
)
body = response.json()
if not response.ok:
    raise RuntimeError(body)

insights = body["insights"]
print(f'{insights["engagementsPerHour"]} engagements an hour, {insights["engagementPerView"]}% of views')

How a tweet performs

Use GET /x/tweets/{id}/insights to see how fast a tweet draws engagement and how far it spreads. Name the tweet by ID or URL. Engagements are likes, replies, reposts, and quotes. amplification is reposts and quotes per like, and conversation is replies per like. A rate is null when nothing divides it, such as a tweet without views.

Path parameters

string

required

Tweet ID or URL-encoded tweet URL, such as x.com/nasa/status/20. See path IDs.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object

string

ID of the tweet.

string | null

ID of the author.

string | null

Username of the author.

string | null

When the tweet went up.

number | null

Hours since the tweet went up.

object

Likes, replies, reposts, quotes, bookmarks, and views.

number

Likes, replies, reposts, and quotes.

number | null

Engagements per hour since the tweet went up.

number | null

Engagements as a percent of views.

number | null

Engagements as a percent of the author’s followers.

number | null

Reposts and quotes per like.

number | null

Replies per like.

400 Invalid input

{ "error": "invalid_tweet_id" }

Send a tweet ID or a tweet URL.

404 Tweet not found

{ "error": "tweet_not_found" }

A tweet X doesn’t have 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.

Related. User engagement insights · Get tweet · Viral score

{
  "insights": {
    "tweetId": "2102882545427714266",
    "authorId": "11348282",
    "authorUserName": "NASA",
    "createdAt": "2026-09-23T22:07:23.000Z",
    "ageHours": 133.88
  }
}

{
  "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": "tweet_not_found",
  "message": "Tweet not found. Check the tweet ID."
}

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

Tweet engagement API: velocity & reach on X

curl --request GET \
  --url https://xquik.com/api/v1/x/tweets/{id}/insights

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/tweets/{id}/insights"

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

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

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

	fmt.Println(string(body))

}

{
  "insights": {
    "tweetId": "<string>",
    "authorId": {},
    "authorUserName": {},
    "createdAt": {},
    "ageHours": {},
    "metrics": {},
    "engagements": 123,
    "engagementsPerHour": {},
    "engagementPerView": {},
    "engagementRate": {},
    "amplification": {},
    "conversation": {}
  }
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Tweet engagement API: velocity & reach on X

How a tweet performs

Path parameters

Headers

Response

200 OK

400 Invalid input

404 Tweet not found

401 Unauthenticated

402 Payment required

502 X API unavailable

​How a tweet performs

​Path parameters

​Headers

​Response

​200 OK

​400 Invalid input

​404 Tweet not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

How a tweet performs

Path parameters

Headers

Response

200 OK

400 Invalid input

404 Tweet not found

401 Unauthenticated

402 Payment required

502 X API unavailable