GensivDocs
AcademyAPI referenceMCP

Basics

OverviewAuthenticationRate limitsErrors

Endpoints

Get visibility overview GETGet visibility by country GETGet visibility heatmap GET
Visibility

List brand engines GET

The engines a brand tracks, with the response math for the plan cap.

Get visibility by country GET

The brand's visibility per response country.

Gensiv

Resources

AcademyWebsiteBlogGlossary

Developer tools

API referenceMCP serverChangelog

Support

Contact supportGetting startedRate limits

© 2026 Gensiv. All rights reserved.

Visibility

Get visibility overview

GET
/brands/{brandId}/dashboard/overview

Visibility, share of voice and position for the brand and its competitors.

Authorization

apiKey
headerx-api-key<token>

Workspace API key from Settings > API keys. Also accepted as Authorization: Bearer gsk_...

Path Parameters

brandId*string
Formatuuid

Query Parameters

engines?string

Comma-separated engine slugs

Lengthlength <= 500
types?string

Comma-separated prompt types

Lengthlength <= 200
intents?string

Comma-separated prompt intents

Lengthlength <= 200
topics?string

Comma-separated topic ids

Lengthlength <= 2000
countries?string

Comma-separated ISO country codes, lowercase

Lengthlength <= 1000
from?string

Answered on or after this UTC date; omit for all time

Match^\d{4}-\d{2}-\d{2}$
to?string

Answered on or before this UTC date; omit for today

Match^\d{4}-\d{2}-\d{2}$

Response Body

KPIs and daily series per tracked brand

application/json
  1. response
  1. response
  2. …
days*array<string>
latestDay*string|null
responses*integer
latestResponses*integer
mentions*integer

All tracked brand mentions in scope

brands*array<>
tracked*array<>
countries*array<>

Countries with responses, ignoring the countries filter

Example Request
curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/dashboard/overview'
Example Response
{  "days": [    "string"  ],  "latestDay": "string",  "responses": 0,  "latestResponses": 0,  "mentions": 0,  "brands": [    {      "key": "string",      "metrics": {        "latest": 0,        "average": 0,        "voice": 0,        "position": 0,        "mentions": 0      },      "previous": {        "latest": 0,        "average": 0,        "voice": 0,        "position": 0,        "mentions": 0      },      "visibility": [        0      ],      "voice": [        0      ],      "position": [        0      ]    }  ],  "tracked": [    {      "key": "string",      "name": "string",      "domain": "string",      "logoUrl": "string",      "isBrand": true    }  ],  "countries": [    {      "code": "string",      "responses": 0    }  ]}

List brand engines GET

The engines a brand tracks, with the response math for the plan cap.

Get visibility by country GET

The brand's visibility per response country.

Start free trial
Start free trial
Example Request
curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/dashboard/overview'
{
  "days": [
    "string"
  ],
  "latestDay": "string",
  "responses": 0,
  "latestResponses": 0,
  "mentions": 0,
  "brands": [
    {
      "key": "string",
      "metrics": {
        "latest": 0,
        "average": 0,
        "voice": 0,
        "position": 0,
        "mentions": 0
      },
      "previous": {
        "latest": 0,
        "average": 0,
        "voice": 0,
        "position": 0,
        "mentions": 0
      },
      "visibility": [
        0
      ],
      "voice": [
        0
      ],
      "position": [
        0
      ]
    }
  ],
  "tracked": [
    {
      "key": "string",
      "name": "string",
      "domain": "string",
      "logoUrl": "string",
      "isBrand": true
    }
  ],
  "countries": [
    {
      "code": "string",
      "responses": 0
    }
  ]
}