GensivDocs
AcademyAPI referenceMCP

Basics

OverviewAuthenticationRate limitsErrors

Endpoints

List prompts GETAdd prompts POSTGet prompt insights GETBulk update prompts POSTTag prompts POSTSet prompt topics POSTUpdate prompt PATCH
Prompts

Add prompts POST

Add prompts; type comes from brand and competitor names, intent from AI.

Bulk update prompts POST

Change the type, intent, location or enabled state of prompts, or delete them.

Gensiv

Resources

AcademyWebsiteBlogGlossary

Developer tools

API referenceMCP serverChangelog

Support

Contact supportGetting startedRate limits

© 2026 Gensiv. All rights reserved.

Prompts

Get prompt insights

GET
/brands/{brandId}/prompts/{promptId}/insights

Visibility, share of voice and position per tracked brand for one prompt.

Authorization

apiKey
headerx-api-key<token>

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

Path Parameters

brandId*string
Formatuuid
promptId*string
Formatuuid

Query Parameters

from?string

Answered on or after this UTC date

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

Answered on or before this UTC date

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

Response Body

Totals, ranking and one row per UTC day

application/json
  1. response
  1. response
  2. …
prompt*
responses*integer
brands*array<>
ranking*array<>
days*array<>
Example Request
curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08/insights'
Example Response
{  "prompt": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "text": "string",    "type": "string",    "intent": "string",    "countryCode": "string",    "enabled": true,    "createdAt": "2019-08-24T14:15:22Z"  },  "responses": 0,  "brands": [    {      "key": "string",      "name": "string",      "domain": "string",      "logoUrl": "string",      "isBrand": true    }  ],  "ranking": [    {      "key": "string",      "visibility": 0,      "share": 0,      "position": 0,      "mentions": 0    }  ],  "days": [    {      "day": "string",      "responses": 0,      "brands": [        {          "key": "string",          "visibility": 0,          "share": 0,          "position": 0,          "mentions": 0        }      ]    }  ]}

Add prompts POST

Add prompts; type comes from brand and competitor names, intent from AI.

Bulk update prompts POST

Change the type, intent, location or enabled state of prompts, or delete them.

Start free trial
Start free trial
Example Request
curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/prompts/497f6eca-6276-4993-bfeb-53cbbbba6f08/insights'
{
  "prompt": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "text": "string",
    "type": "string",
    "intent": "string",
    "countryCode": "string",
    "enabled": true,
    "createdAt": "2019-08-24T14:15:22Z"
  },
  "responses": 0,
  "brands": [
    {
      "key": "string",
      "name": "string",
      "domain": "string",
      "logoUrl": "string",
      "isBrand": true
    }
  ],
  "ranking": [
    {
      "key": "string",
      "visibility": 0,
      "share": 0,
      "position": 0,
      "mentions": 0
    }
  ],
  "days": [
    {
      "day": "string",
      "responses": 0,
      "brands": [
        {
          "key": "string",
          "visibility": 0,
          "share": 0,
          "position": 0,
          "mentions": 0
        }
      ]
    }
  ]
}