Tags and topics

A brand's prompts can be grouped in four ways. Every group works as a filter on the metrics and responses endpoints, and you can ask for metrics per group.

Topics are exclusive, so the responses in each topic add up to the brand's total. Tags overlap: a prompt with two tags counts in both.

Funnel stagesCopy Anchor Link

Branded promptsCopy Anchor Link

A prompt is branded when its text names your brand. Branded prompts show how AI describes you rather than whether it recommends you, so their visibility is usually high. Filter with branded=non-branded to measure how often you are recommended to buyers who have not named you.

List a brand's topics and tagsCopy Anchor Link

GET /brands/{brandId}/prompt-groups returns the topics and tags with their ids.

{
  "topics": [
    { "id": "3b0f57eb-ae2d-4d03-a049-55592c2d3f2a", "name": "Issue tracking" }
  ],
  "tags": [
    { "id": "9c1d7f1e-52a4-4a7e-8f1b-0a2f6f4d3c11", "name": "High intent" }
  ]
}

GET /brands/{brandId}/prompts returns each prompt's topic, tags, funnelStage and branded.

Filter metrics and responsesCopy Anchor Link

These endpoints accept topicId, tagId and branded:

• GET /brands/{brandId}/metrics
• GET /brands/{brandId}/metrics/daily
• GET /brands/{brandId}/metrics/prompts
• GET /brands/{brandId}/responses

curl "https://api.gensiv.com/v1/brands/$BRAND_ID/metrics?topicId=$TOPIC_ID&branded=non-branded" \
  -H "Authorization: Bearer $GENSIV_API_KEY"

When you pass more than one filter, a response must match all of them.

Metrics per groupCopy Anchor Link

GET /brands/{brandId}/metrics/groups returns one row per group. Set groupBy to topic (the default), tag, funnelStage or branded.

{
  "from": "2026-09-02",
  "to": "2026-10-01",
  "groupBy": "topic",
  "data": [
    {
      "groupId": "3b0f57eb-ae2d-4d03-a049-55592c2d3f2a",
      "name": "Issue tracking",
      "prompts": 3,
      "responses": 533,
      "visibility": 42,
      "visibilityChange": 10.3,
      "avgPosition": 1.6,
      "sentiment": 86,
      "shareOfVoice": 9.3
    }
  ]
}

Prompts that are not in any group come back in a row with groupId: null.

Groups follow the promptCopy Anchor Link

Group metrics use each prompt's current topic and tags. If you move a prompt to another topic, all of its past responses move with it, so a topic's history can change after you reorganise.