Social API reference

Social API · Hashtags

get/v1/communities/{community_id}/hashtags/{tag}Auth

Get a single hashtag with its current published post count.

Path parameters

community_id*string

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

tag*string

Lowercase tag (without `#`).

Response · 200 Hashtag detail.

community_id*string · uuid

Owning community UUID.

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

tag*string

Lowercase tag (1..32 chars from [a-z0-9_]).

Example: "storymode"

first_used_at*string · date-time

ISO timestamp the tag first appeared in this community.

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

window_post_count*number

Published posts using the tag inside the trending window; non-null only when `order=trending` (task 023).

Example: null

post_count*number

Number of currently-published posts using the tag.

Example: 17

Example

Request

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

Response

{
  "community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
  "tag": "storymode",
  "first_used_at": "2026-05-01T12:00:00.000Z",
  "window_post_count": null,
  "post_count": 17
}