---
title: "GET /api/v1/x/communities/{id}/analytics"
method: GET
path: "/api/v1/x/communities/{id}/analytics"
tags: ["Communities"]
---

# GET /api/v1/x/communities/{id}/analytics

`GET /api/v1/x/communities/{id}/analytics`

## Request

- Base URL: `https://xquik.com`
- URL: `https://xquik.com/api/v1/x/communities/{id}/analytics`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - none

Returns community activity for X's latest period. Includes likes, new members, posts, replies & unique posters. Each metric has a count and a changePercent. Each request costs 1 credit.

## Path parameters

- `id` string, required

## Query parameters

- `fields` string
- `omit` string

## Response `200`

Community activity & growth for X's latest period

- CommunityAnalytics: Community activity & growth for X's latest period.
  - `id` string, required: The community ID from your request.
  - `periodEndsAt` string, date-time, required: The end of X's latest period, in UTC.
  - `metrics` object, required: The period's activity, each metric with its count and changePercent. likes counts likes on community posts and newMembers the accounts that joined. posts counts the community posts and replies the replies to them. uniquePosters counts the distinct accounts that posted.
    - `likes` CommunityAnalyticsMetric, required: A community metric for X's latest period & its percent change.
      - `count` integer, required: Total for this metric during X's latest period.
      - `changePercent` number, required: Change in percent from the same figure 1 day earlier. Values stay unrounded.
    - `newMembers` CommunityAnalyticsMetric, required: A community metric for X's latest period & its percent change.
      - `count` integer, required: Total for this metric during X's latest period.
      - `changePercent` number, required: Change in percent from the same figure 1 day earlier. Values stay unrounded.
    - `posts` CommunityAnalyticsMetric, required: A community metric for X's latest period & its percent change.
      - `count` integer, required: Total for this metric during X's latest period.
      - `changePercent` number, required: Change in percent from the same figure 1 day earlier. Values stay unrounded.
    - `replies` CommunityAnalyticsMetric, required: A community metric for X's latest period & its percent change.
      - `count` integer, required: Total for this metric during X's latest period.
      - `changePercent` number, required: Change in percent from the same figure 1 day earlier. Values stay unrounded.
    - `uniquePosters` CommunityAnalyticsMetric, required: A community metric for X's latest period & its percent change.
      - `count` integer, required: Total for this metric during X's latest period.
      - `changePercent` number, required: Change in percent from the same figure 1 day earlier. Values stay unrounded.

## Other responses

- `400`: Invalid input. A value past its maxLength gets this answer, & the message names the field & its limit.
- `401`: Unauthenticated
- `402`: Payment required. MPP reads include `WWW-Authenticate`. Authenticated reads include balances, plus checkout when the key can open it. A key that reads only gets the account page instead. A failed request never creates checkout. A caller on a plan gets top-up only, plus `credits_renew_at` when the plan renews. Guest keys offer top-up.
- `404`: Not found
- `424`: Dependency unavailable, unauthorized, or limited. Default v1 uses 502. Best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself, or when its filters matched none of the last 3,000 posts read. The message says how far back the search read.
- `429`: Too many requests right now. Each user gets 500 reads a second. Each minute allows 120 writes & 60 deletes. `x_api_rate_limited` means X limits this read for now. Neither answer costs anything. Wait for the seconds in `Retry-After`, then retry.
- `500`: Unexpected error.
- `502`: Dependency unavailable, unauthorized, or limited. Default v1 uses 502. Best-practice responses use 424 for transparent dependency failures. Search answers 424 `search_unavailable` when X fails the query itself, or when its filters matched none of the last 3,000 posts read. The message says how far back the search read.
- `503`: Retry x_api_unavailable after Retry-After. With X-Xquik-Busy, retry until your deadline.
- `default`: Unexpected error.

## Changes

- **2026-10-20** `45942c75fdc2`: 20 warning
  - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `429`
  - added the new `topup_in_progress` enum value to the `allOf[#/components/schemas/Error]/error/oneOf[subschema #2: StructuredError]/code` response property for the response status `429`
  - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `400`
  - added the new `topup_in_progress` enum value to the `error/oneOf[subschema #1: LegacyErrorCode]/` response property for the response status `401`
  - …16 more

[Operation history](https://skmtc.dev/xquik-dev/apis/xquik-api/changes/api/v1/x/communities/:id/analytics/get.md)

---

[API](https://skmtc.dev/xquik-dev/apis/xquik-api.md) · [All operations](https://skmtc.dev/xquik-dev/apis/xquik-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xquik-dev/apis/xquik-api/revisions/45942c75fdc2?raw)