/v1/communities/{community_id}/actors/{actor_id}/insightsAuthAn 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*stringSocial community UUID.
actor_id*string · uuidId of the actor.
Query parameters
fromstring · dateWindow start (YYYY-MM-DD, UTC). Default 30 days before `to`.
tostring · dateWindow end (YYYY-MM-DD, UTC), inclusive. Default today.
Response · 200 Actor insights.
actor_id*string · uuidId of the actor.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
community_id*string · uuidId of the community the actor belongs to.
Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"
follower_count*numberLive follower count.
Example: 1240
daily*arrayFollower 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_TOKENimport { Social } from "@productcraft/social";
// Reads PRODUCTCRAFT_API_KEY from the environment
const social = new Social();
const actorInsights = await social.community("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f").actors.insights("3f0c3c1e-8a2b-4c55-9d3f-0a1b2c3d4e5f");social.community(…).actors.insights(actorId, params?, options?): Social.ActorInsights
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
}
]
}