Metrics

Get daily metrics

Markdown
GET
/v1/brands/{brandId}/metrics/daily

The same metrics broken down by day, engine and entity. Built for spreadsheets and BI tools.

Authorization

bearer
AuthorizationBearer <token>

An API key from Settings → API keys in the Gensiv app.

In: header

Path Parameters

brandId*string

A brand id from GET /v1/brands.

Formatuuid

Query Parameters

from?string

First day to include, in UTC (YYYY-MM-DD). Defaults to 29 days before to.

to?string

Last day to include, in UTC (YYYY-MM-DD). Defaults to today.

engine?string

Only include responses from this engine. Use a slug from GET /v1/engines.

promptId?string

Only include responses to this prompt.

Formatuuid
topicId?string

Only include responses to prompts in this topic. Use an id from GET /v1/brands/{brandId}/prompt-groups.

Formatuuid
tagId?string

Only include responses to prompts with this tag. Use an id from GET /v1/brands/{brandId}/prompt-groups.

Formatuuid
branded?string

branded keeps only prompts that name the brand, non-branded leaves them out.

Value in

  • "branded"
  • "non-branded"
breakdown?string

engine returns one row per day, engine and entity. none combines all engines into one row per day and entity.

Default"engine"

Value in

  • "engine"
  • "none"

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/daily"
{  "from": "2026-09-01",  "to": "2026-09-30",  "data": [    {      "date": "2026-09-28",      "engine": "chatgpt",      "entityType": "brand",      "competitorId": null,      "name": "Acme",      "responses": 16,      "mentions": 7,      "visibility": 43.8,      "shareOfVoice": 33.3,      "avgPosition": 2,      "sentiment": 75    }  ]}