Social API reference

Social API · Insights

get/v1/communities/{community_id}/actors/{actor_id}/insightsAuth

An actor's follower time series: live follower_count plus a nightly-snapshot daily series over ?from/?to (default trailing 30 days).

Path parameters

community_id*string

Social community UUID.

actor_id*string · uuid

Id of the actor.

Query parameters

fromstring · date

Window start (YYYY-MM-DD, UTC). Default 30 days before `to`.

tostring · date

Window end (YYYY-MM-DD, UTC), inclusive. Default today.

Response · 200 Actor insights.

actor_id*string · uuid

Id of the actor.

Example: "aaaaaaaa-0000-0000-0000-000000000001"

community_id*string · uuid

Id of the community the actor belongs to.

Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"

follower_count*number

Live follower count.

Example: 1240

daily*array

Follower count per day in the requested window, oldest first.

Example

Request

GET https://social.productcraft.co/v1/communities/{community_id}/actors/{actor_id}/insights
Authorization: Bearer YOUR_TOKEN

Response

{
  "actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
  "community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "follower_count": 1240,
  "daily": [
    {
      "day": "2026-05-01",
      "follower_count": 1240
    }
  ]
}