Social API reference

Social API · Posts

post/v1/communities/{community_id}/posts/impressionsAuth

Batch-increment impression (`view_count`) counters on a list of posts. Client-side debounced; missing post ids are silently skipped (so a deleted post mid-batch doesn’t fail the rest). Renamed from `POST /posts/views` (task 008 / G14) to disambiguate from the story-side per-post `/posts/:post_id/views` route.

Path parameters

community_id*string

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

Request body

post_ids*array

UUIDs of posts that became visible to the viewer in this batch. Capped at 200 to keep the payload sensible — the server will silently skip ids that aren't in the community or have been removed.

Example: ["bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb","cccccccc-cccc-cccc-cccc-cccccccccccc"]

actor_idstring · uuid

The acting actor (the viewer). When present, the impressions count toward the post's unique reach (deduped per viewer per day); omit for anonymous views, which count total views but not reach.

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

viewer_actor_idstring · uuid

Deprecated alias of `actor_id`; send `actor_id`.

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

Response · 204

Impressions recorded (or no-op if every id was missing).

Example

Request

POST https://social.productcraft.co/v1/communities/{community_id}/posts/impressions
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

{
  "post_ids": [
    "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
    "cccccccc-cccc-cccc-cccc-cccccccccccc"
  ],
  "actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
  "viewer_actor_id": "aaaaaaaa-0000-0000-0000-000000000001"
}