post/gettags

Returns tags used by selected or filtered posts.

Overview

Use this endpoint to retrieve unique tag ids and labels from a post subset.

Authentication

Authentication behavior is partially confirmed. See Authentication.

Permissions

Authentication is required.

Endpoint

post/gettags

Purpose

Collects distinct tag ids from matched posts and maps them to tag labels.

Method and path

POST /post/gettags

Headers

Header	Required	Description
X-Api-Key or X_API_KEY	yes	API key.
Content-Type	yes	application/json.

Request body

Field	Type	Required	Description
projectId	integer	yes	Project identifier.
uuidArray	string or array<string>	no	Explicit post UUID list.
limit	integer	no	Max matched posts. Default 100.
Shared filters	mixed	no	Used when uuidArray is absent.

Example request

curl -X POST "$SIGNAL_API_BASE_URL/post/gettags" \
  -H "X-Api-Key: $SIGNAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "projectId": 123,
    "uuidArray": ["<post_uuid>", "<post_uuid>"]
  }'

Example response

{
  "3": "Brand",
  "19": "Campaign"
}

Notes

• Filtering by UUID uses uuid field.