Metrics
Get visibility metrics
Visibility, share of voice, average position and sentiment for the brand and each tracked competitor over a date range.
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"
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"{ "from": "2026-09-01", "to": "2026-09-30", "responses": 480, "data": [ { "entityType": "brand", "competitorId": null, "name": "Acme", "visibility": 42.5, "shareOfVoice": 31.2, "avgPosition": 2.4, "sentiment": 71 } ]}