Analytics

The connected account's public performance, collected once a day by squidX: followers, impressions and engagement over time, and the posts behind the numbers.

Get the overview

GETsquidx.io/api/v1/analytics/overviewanalytics:read

Followers, posts, impressions and engagements over a window, each with the delta against the previous window of the same length. followers.since is set when follower history does not reach the start of the window.

Get the overview parameters
Name	In	Type	Description
`range`	query	string	7d, 30d, 90d or all. Default 30d.
`series`	query	boolean	true adds the daily points behind each number, as [{ date, value }].

Request

curl "https://squidx.io/api/v1/analytics/overview?range=30d" \
  -H "Authorization: Bearer sqx_your_key"

Response · 200

{
  "data": {
    "range": "30d",
    "window": {
      "start": "2026-08-25",
      "end": "2026-09-23"
    },
    "followers": {
      "value": 4821,
      "delta": 312
    },
    "posts": {
      "value": 46,
      "delta": 9
    },
    "impressions": {
      "value": 391204,
      "delta": 58870
    },
    "engagements": {
      "value": 7210,
      "delta": 1204
    },
    "streak": 12
  }
}

List top posts

GETsquidx.io/api/v1/analytics/postsanalytics:read

The account's own posts with their public metrics, best first.

List top posts parameters
Name	In	Type	Description
`range`	query	string	7d, 30d, 90d or all. Default 30d.
`sort`	query	string	impressions (default), engagements, likes, replies, reposts, bookmarks or posted_at. Always descending.
`limit`	query	integer	Rows per page, 1 to 200. Default 50.
`offset`	query	integer	Rows to skip. Default 0. The response meta carries the total.

Request

curl "https://squidx.io/api/v1/analytics/posts?range=90d&sort=engagements&limit=5" \
  -H "Authorization: Bearer sqx_your_key"

Response · 200

{
  "data": [
    {
      "id": "1969431290813001729",
      "url": "https://x.com/aschapmann/status/1969431290813001729",
      "text": "Built a thing. Here is what I learned.",
      "kind": "post",
      "postedAt": "2026-09-20T09:01:13.000Z",
      "impressions": 18420,
      "likes": 212,
      "replies": 34,
      "reposts": 19,
      "quotes": 4,
      "bookmarks": 61,
      "engagements": 330,
      "engagementRate": 0.0179
    }
  ],
  "meta": {
    "total": 131,
    "limit": 5,
    "offset": 0,
    "range": "90d"
  }
}