Metrics
Get metrics per prompt group
Visibility, position, sentiment and share of voice for each topic, tag, funnel stage or branded segment. Numbers use each prompt's current groups.
Authorization
bearer An API key from Settings → API keys in the Gensiv app.
In: header
Path Parameters
A brand id from GET /v1/brands.
uuidQuery Parameters
First day to include, in UTC (YYYY-MM-DD). Defaults to 29 days before to.
Last day to include, in UTC (YYYY-MM-DD). Defaults to today.
Only include responses from this engine. Use a slug from GET /v1/engines.
Only include responses to this prompt.
uuidOnly include responses to prompts in this topic. Use an id from GET /v1/brands/{brandId}/prompt-groups.
uuidOnly include responses to prompts with this tag. Use an id from GET /v1/brands/{brandId}/prompt-groups.
uuidbranded keeps only prompts that name the brand, non-branded leaves them out.
Value in
- "branded"
- "non-branded"
How to group prompts.
"topic"Value in
- "topic"
- "tag"
- "funnelStage"
- "branded"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/metrics/groups"{ "from": "2026-09-01", "to": "2026-09-30", "groupBy": "topic", "data": [ { "groupId": "string", "name": "Small teams", "prompts": 0, "responses": 0, "visibility": 0, "visibilityChange": 0, "avgPosition": 0, "sentiment": 0, "shareOfVoice": 0 } ]}