v3

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-012582298.4 KB
Analytics

Get followers analytics

Retrieve daily follower counts for a platform in a social set between start_date and end_date (inclusive).

Required permission: READ access to this social set.

Notes:

  • platform is a path parameter (for example: x, linkedin).
  • This endpoint is social-set scoped and platform-scoped to support analytics expansion.
  • Currently, only x is supported.
  • Returns a totals-only daily follower series with the latest in-range follower count.
  • If start_date and end_date are omitted, defaults to the last 30 days.
  • Date ranges larger than 366 days are rejected.
get/v2/social-sets/{social_set_id}/analytics/{platform}/followers

Path parameters

social_set_idinteger required
platformstring required

Query parameters

start_datestring nullable

Start date for the follower series (YYYY-MM-DD). Defaults to 29 days before end_date, or before today when end_date is omitted.

Start date for the follower series (YYYY-MM-DD). Defaults to 29 days before end_date, or before today when end_date is omitted.

end_datestring nullable

End date for the follower series (YYYY-MM-DD). Defaults to today in the social set's timezone.

End date for the follower series (YYYY-MM-DD). Defaults to today in the social set's timezone.

Response

Daily follower counts for a social set on X.

platform'x' required

Social platform for this analytics series. Currently only x is supported.

current_followers_countinteger nullable

Latest non-null follower count in the returned date range.

Example response

{
  "platform": "x"
}