Posteady
Posteady Docs
User guideDeveloper guidesAPI referenceMCP
API referenceAccounts and workspaces

Get account analytics

Read follower changes and post performance for each account over a period.

GET
/api/v1/accounts/analytics
curl -X GET "https://example.com/api/v1/accounts/analytics?provider=instagram&accountId=11111111-1111-4111-8111-111111111111&since=2026-10-01T00%3A00%3A00Z&until=2026-11-01T00%3A00%3A00Z"

{  "since": "2026-10-01T00:00:00.000Z",  "until": "2026-11-01T00:00:00.000Z",  "rangeDays": 31,  "previousSince": "2026-08-31T00:00:00.000Z",  "accounts": [    {      "accountId": "11111111-1111-4111-8111-111111111111",      "provider": "threads",      "username": "your_brand",      "displayName": "Your brand",      "followers": {        "current": 1250,        "atSince": 1100,        "atUntil": 1240,        "change": 140      },      "postCount": 18,      "reactions": 420,      "comments": 64,      "engagementRate": 3.85,      "previous": {        "postCount": 15,        "reactions": 350,        "comments": 51,        "engagementRate": 3.4      }    },    {      "accountId": "99999999-9999-4999-8999-999999999999",      "provider": "youtube",      "username": "your_channel",      "displayName": "Your channel",      "followers": {        "current": 820,        "atSince": null,        "atUntil": null,        "change": null      },      "postCount": 4,      "reactions": 96,      "comments": 12,      "engagementRate": 2.1,      "previous": {        "postCount": 3,        "reactions": 70,        "comments": 9,        "engagementRate": 1.95      }    }  ]}

Return follower changes and post performance for each supported account in the API key's workspace over a period, with the same definitions as the Posteady analytics screen. By default the request reads the last 90 days. Pass since and until to read another period of up to 90 days. previous holds the same metrics for the period of equal length that ends at since. Post metrics count published posts in the period and exclude private posts (TikTok SELF_ONLY, and YouTube private or unlisted videos). followers.atSince and followers.atUntil come from daily follower snapshots by UTC date. Only Threads, X, Instagram, and LinkedIn have snapshots, so these values are null for other platforms. This request reads synchronized data and does not refresh the platforms, except that it reads the current follower count of a Facebook Page from Facebook.

AuthorizationBearer <token>

In: header

Query parameters

provider?string

Value in

  • "threads"
  • "x"
  • "linkedin"
  • "tiktok"
  • "instagram"
  • "youtube"
  • "facebook"
accountId?string
Formatuuid
since?string

Start of the period, inclusive. Use an ISO 8601 timestamp with a timezone offset, and URL-encode + as %2B. Defaults to 90 days before until.

Formatdate-time
until?string

End of the period, exclusive. Defaults to now. The period from since to until can be at most 90 days.

Formatdate-time

Response body

application/json

application/json

application/json