Social API reference

Social API · Counters

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

Denormalised counters for one actor (followers, following, posts, comments, blocks).

Path parameters

community_id*string

Social community UUID. Must belong to the PAK's workspace.

actor_id*string

Social actor UUID (returned from POST /actors).

Response · 200 Counters for the actor.

actor_id*string · uuid

Actor UUID.

Example: "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"

community_id*string · uuid

Owning community UUID.

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

follower_count*number

How many actors follow this actor.

Example: 42

following_count*number

How many actors this actor follows.

Example: 17

post_count*number

Published posts authored by this actor.

Example: 5

comment_count*number

Published comments authored by this actor.

Example: 12

blocks_count*number

Actors this actor has blocked.

Example: 0

updated_at*string · date-time

ISO timestamp of the last counter update.

Example: "2026-05-01T12:00:00.000Z"

Example

Request

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

Response

{
  "actor_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "follower_count": 42,
  "following_count": 17,
  "post_count": 5,
  "comment_count": 12,
  "blocks_count": 0,
  "updated_at": "2026-05-01T12:00:00.000Z"
}