Communities

Get community activity & growth

Changed on

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.

get/x/communities/{id}/analytics

Request

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

Path parameters

idstring required
Example:1500000000000000000

X Community ID, a number up to 19 digits. Another value gets a free 400 invalid_community_id before X is read.

Query parameters

fieldsstring
Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring
Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

Community activity & growth for X's latest period

idstring required

The community ID from your request.

periodEndsAtstring date-time required

The end of X's latest period, in UTC.

Example response

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

Changes

  • 245194cd4ea7Revision changes
    • warning

      added the new topup_in_progress enum value to the ///// response property for the response status

    • warning

      added the new topup_in_progress enum value to the ////// response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the / response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the // response property for the response status

    • warning

      added the new topup_in_progress enum value to the ////// response property for the response status

    • warning

      added the new topup_in_progress enum value to the /////// response property for the response status

  • d17988b4a85dRevision changes
    • breaking

      added to the response body oneOf list for the response status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property const value Ask the user to confirm a payment option before creating checkout. was added for the status

    • info

      removed the Ask the user to confirm a payment option before creating checkout. enum value from the //// response property for the response status

    • info

      removed the Ask the user to top up at /dashboard/account. This key cannot open checkout. enum value from the //// response property for the response status