Social API reference

Social API · Counters

get/v1/communities/{community_id}/countersAuth

Batch counters (max 100 actors per call) — render a member list with follower badges from ONE call instead of one per actor. Unknown actor_ids come back in `missing[]` instead of failing the read.

Path parameters

community_id*string

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

Query parameters

actor_ids*string

Comma-separated actor UUIDs (max 100, de-duplicated).

Response · 200 Counters for each actor found plus the `missing[]` ids.

data*array

Counters for each actor found, in `actor_ids` order (after de-duplication).

missing*array

actor_ids with no actor in this community.

Example: []

Example

Request

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

Response

{
  "data": [
    {
      "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"
    }
  ],
  "missing": []
}