GET
/
v1
/
teams
/
{teamId}
/
analytics
/
accounts
TypeScript client
import { OctosparkClient } from '@octospark/sdk'

const client = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

const response = await client.social.listAccountAnalytics({
  teamId: process.env.OCTOSPARK_TEAM_ID ?? "teamId",
  query: {},
})
{
  "data": [
    {
      "socialAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "displayName": "<string>",
      "profileHandle": "<string>",
      "capabilityStatus": "<string>",
      "uiEnabled": true,
      "collectedAt": "<string>",
      "metrics": {
        "followerCount": 123,
        "followingCount": 123,
        "subscriberCount": 123,
        "postCount": 123,
        "viewCount": 123,
        "likeCount": 123,
        "commentCount": 123,
        "shareCount": 123,
        "saveCount": 123,
        "reachCount": 123,
        "impressionCount": 123,
        "profileViewCount": 123
      },
      "error": {
        "code": "<string>",
        "message": "<string>"
      },
      "series": [
        {
          "snapshotDate": "<string>",
          "metrics": {
            "followerCount": 123,
            "followingCount": 123,
            "subscriberCount": 123,
            "postCount": 123,
            "viewCount": 123,
            "likeCount": 123,
            "commentCount": 123,
            "shareCount": 123,
            "saveCount": 123,
            "reachCount": 123,
            "impressionCount": 123,
            "profileViewCount": 123
          }
        }
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

Query Parameters

from
string

Start of the follower-history window, ISO 8601 timestamp or YYYY-MM-DD (inclusive). Provide with to to include a per-account daily series.

Example:

"2026-05-01"

to
string

End of the follower-history window, ISO 8601 timestamp or YYYY-MM-DD (inclusive).

Example:

"2026-05-31"

Response

Success

data
object[]
required