Twitter engagement rate API for X profiles

{
  "insights": {
    "userId": "11348282",
    "userName": "NASA",
    "followers": 92376187,
    "following": 115,
    "posts": 74336
  }
}

{
  "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": "user_not_found",
  "message": "X user not found. Check the username."
}

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

users

{id}

insights

Twitter engagement rate API for X profiles

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/users/{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": {
    "userId": "<string>",
    "userName": "<string>",
    "followers": 123,
    "following": 123,
    "posts": 123,
    "accountAgeDays": {},
    "postsPrivate": true,
    "sample": {},
    "averages": {},
    "engagementRate": {},
    "engagementPerView": {},
    "postsPerDay": {},
    "topPostId": {}
  },
  "message": "<string>"
}

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

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

const response = await fetch("https://xquik.com/api/v1/x/users/nasa/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.userName}: ${insights.engagementRate}% engagement, ${insights.postsPerDay} posts a day`,
);

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/users/nasa/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["userName"]}: {insights["engagementRate"]}% engagement, {insights["postsPerDay"]} posts a day')

A profile’s engagement at a glance

Use GET /x/users/{id}/insights to size up an account before you work with it. Name the user by user ID, username, or profile URL. The report reads the profile’s counts and its last 20 posts. Reposts and the pinned post stay out of the averages, so they describe the account’s own recent posts. Engagements are likes, replies, reposts, and quotes. A rate is null when nothing divides it, such as a profile without posts of its own. A protected account’s posts are private. Its report has its counts and account age, postsPrivate: true, and a message that says so, at the same 1 credit.

Path parameters

string

required

User ID, username with or without @, or URL-encoded profile URL, such as x.com/nasa. 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 profile.

string

Username of the profile.

number

Followers.

number

Accounts the user follows.

number

Posts the user has made.

number | null

Whole days since the account joined X.

boolean

true when only the account’s followers see its posts. The report then has its counts only.

object

The posts the averages read: posts, and when the oldestAt and newestAt of them went up.

object | null

Likes, replies, reposts, quotes, bookmarks, views, and engagements per post. null without posts.

number | null

Average engagements per post, as a percent of followers.

number | null

Engagements as a percent of views across the sample.

number | null

Sampled posts per day, from the oldest one until now.

string | null

The sampled post with the most engagements.

string

Says why the report has counts only, for a protected account.

400 Invalid input

{ "error": "invalid_user_id" }

Send a user ID, a username, or a profile URL.

404 User not found

{ "error": "user_not_found", "message": "X user not found. Check the username." }

A user X doesn’t know 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. Tweet engagement insights · Get user · User timeline

{
  "insights": {
    "userId": "11348282",
    "userName": "NASA",
    "followers": 92376187,
    "following": 115,
    "posts": 74336
  }
}

{
  "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": "user_not_found",
  "message": "X user not found. Check the username."
}

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

Twitter engagement rate API for X profiles

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/users/{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": {
    "userId": "<string>",
    "userName": "<string>",
    "followers": 123,
    "following": 123,
    "posts": 123,
    "accountAgeDays": {},
    "postsPrivate": true,
    "sample": {},
    "averages": {},
    "engagementRate": {},
    "engagementPerView": {},
    "postsPerDay": {},
    "topPostId": {}
  },
  "message": "<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

Twitter engagement rate API for X profiles

A profile’s engagement at a glance

Path parameters

Headers

Response

200 OK

400 Invalid input

404 User not found

401 Unauthenticated

402 Payment required

502 X API unavailable

​A profile’s engagement at a glance

​Path parameters

​Headers

​Response

​200 OK

​400 Invalid input

​404 User not found

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

A profile’s engagement at a glance

Path parameters

Headers

Response

200 OK

400 Invalid input

404 User not found

401 Unauthenticated

402 Payment required

502 X API unavailable