X community analytics API for activity & growth

{
  "id": "1493446837214187523",
  "periodEndsAt": "2026-10-16T23:59:59.999Z",
  "metrics": {
    "likes": {
      "count": 15298,
      "changePercent": -1.2076202776880853
    },
    "newMembers": {
      "count": 557,
      "changePercent": -1.5901060070671376
    },
    "posts": {
      "count": 5108,
      "changePercent": 0.5907837731390311
    },
    "replies": {
      "count": 6851,
      "changePercent": -0.8251302837290099
    },
    "uniquePosters": {
      "count": 1800,
      "changePercent": -0.33222591362126247
    }
  }
}

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

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

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

communities

{id}

analytics

X community analytics API for activity & growth

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

const options = {method: 'GET'};

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

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

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

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

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "periodEndsAt": "<string>",
  "metrics": {
    "likes": {},
    "newMembers": {},
    "posts": {},
    "replies": {},
    "uniquePosters": {}
  },
  "count": 123,
  "changePercent": 123
}

Use the X community analytics API to see how active a community is. One call returns 5 activity counts for the latest period. Each has its change in percent from 1 day earlier.

What each call returns

likes counts likes on the community’s posts.
newMembers counts the accounts that joined.
posts counts the posts in the community.
replies counts the replies to those posts.
uniquePosters counts the distinct accounts that posted.

Each metric has a count and a changePercent. A negative changePercent means the count fell. periodEndsAt gives the end of the period in UTC.

Track community growth over time

Call the endpoint once a day for each community you follow. Store periodEndsAt with the 5 counts. A new periodEndsAt means a new period, so you can chart each metric over time. Compare communities with the same 5 metrics. uniquePosters against posts shows whether a few accounts write most posts.

Each successful call costs 1 credit. A refused ID, a missing community or a failed read costs nothing.

curl "https://xquik.com/api/v1/x/communities/1493446837214187523/analytics" \
  -H "x-api-key: $XQUIK_API_KEY"

import os

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/communities/1493446837214187523/analytics",
    headers={"x-api-key": os.environ["XQUIK_API_KEY"]},
    timeout=30,
)
response.raise_for_status()
analytics = response.json()
print(analytics["periodEndsAt"], analytics["metrics"]["posts"]["count"])

Path parameters

string

required

Numeric X Community ID, such as 1493446837214187523. Copy it from the community’s x.com/i/communities link. Any other value gets a free 400.

Query parameters

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

Your API key. Send this header or Authorization.

string

Bearer followed by your API key or OAuth token.

Response

200 OK

string

The community ID from your request.

string

ISO 8601 end of the latest period, in UTC.

object

The period’s activity. Each metric holds count & changePercent.

Show metrics

object

Likes on the community’s posts.

object

Accounts that joined the community.

object

Posts in the community.

object

Replies to the community’s posts.

object

Distinct accounts that posted.

Each metric object has these fields.

integer

The total for the period. It is never negative.

number

The change in percent from the same figure 1 day earlier, unrounded. A fall is negative.

400 Invalid community ID

{ "error": "invalid_community_id" }

The ID is not a numeric Community ID. Send the number from the community’s link. The call costs nothing.

401 Unauthenticated

{ "error": "unauthenticated" }

Missing or invalid API key.

402 Payment required

Account keys get account options. Guest keys get guest top-up only. Anonymous calls get a direct MPP WWW-Authenticate: Payment challenge. They also get a guest wallet creation action. No checkout starts automatically. Confirm any payment action.

404 Community not found

{ "error": "not_found" }

No community has this ID. Check the ID. The call costs nothing.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

503 Read unavailable

{ "error": "x_api_unavailable" }

The read failed. Retry shortly. The call costs nothing.

Next steps. Community Info for the community’s name & rules, or Community Tweets to read its posts.

{
  "id": "1493446837214187523",
  "periodEndsAt": "2026-10-16T23:59:59.999Z",
  "metrics": {
    "likes": {
      "count": 15298,
      "changePercent": -1.2076202776880853
    },
    "newMembers": {
      "count": 557,
      "changePercent": -1.5901060070671376
    },
    "posts": {
      "count": 5108,
      "changePercent": 0.5907837731390311
    },
    "replies": {
      "count": 6851,
      "changePercent": -0.8251302837290099
    },
    "uniquePosters": {
      "count": 1800,
      "changePercent": -0.33222591362126247
    }
  }
}

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

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

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

X community analytics API for activity & growth

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

const options = {method: 'GET'};

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

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

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

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

	fmt.Println(string(body))

}

{
  "id": "<string>",
  "periodEndsAt": "<string>",
  "metrics": {
    "likes": {},
    "newMembers": {},
    "posts": {},
    "replies": {},
    "uniquePosters": {}
  },
  "count": 123,
  "changePercent": 123
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

X community analytics API for activity & growth

What each call returns

Track community growth over time

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid community ID

401 Unauthenticated

402 Payment required

404 Community not found

429 Rate limit exceeded

503 Read unavailable

​What each call returns

​Track community growth over time

​Path parameters

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid community ID

​401 Unauthenticated

​402 Payment required

​404 Community not found

​429 Rate limit exceeded

​503 Read unavailable

What each call returns

Track community growth over time

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid community ID

401 Unauthenticated

402 Payment required

404 Community not found

429 Rate limit exceeded

503 Read unavailable