Skip to main content
GET https://xquik.com/api/v1/x/communities/{id}/analytics 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 marks a new period. That lets you 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.

Path parameters

Query parameters

Headers

Response

200 OK

Each metric object has these fields.

400 Invalid community ID

{ "error": "invalid_community_id" } The ID is no Community ID or link. Send the community’s link or the number in it. The call costs nothing.

401 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

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

429 Rate limit exceeded

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

503 Read 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.

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 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." }