GensivDocs
AcademyAPI referenceMCP

Basics

OverviewAuthenticationRate limitsErrors

Endpoints

List responses GETCount responses GETGet response GET
Responses

List responses GET

List a brand's analysed responses, filtered, sorted and paged.

Get response GET

Get one response with its answer, mentions and citations.

Gensiv

Resources

AcademyWebsiteBlogGlossary

Developer tools

API referenceMCP serverChangelog

Support

Contact supportGetting startedRate limits

© 2026 Gensiv. All rights reserved.

Responses

Count responses

GET
/brands/{brandId}/responses/overview

Response counts by engine and by engine per UTC day, for the list filters.

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

q?string

Matches the prompt or the answer text

Lengthlength <= 200
promptId?string
Formatuuid
pageId?string

Only responses that cite this cited page

Formatuuid
engines?string

Comma-separated engine slugs

Lengthlength <= 500
types?string

Comma-separated prompt types, matched on the prompt's current type

Lengthlength <= 200
intents?string

Comma-separated prompt intents, matched on the prompt's current intent

Lengthlength <= 200
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}$
citations?string

has: at least one citation, none: no citations

Value in"has""none"
self?string

has: cites the brand's own site, none: does not

Value in"has""none"
competitors?string

Comma-separated competitor ids; matches responses that mention any of them

Lengthlength <= 2000
topics?string

Comma-separated topic ids; matches responses whose prompt is in any of them

Lengthlength <= 2000
scores?string

Comma-separated brand sentiment buckets: low (<30), mixed (30 to 49), fair (50 to 74), high (75 to 100)

Lengthlength <= 100

Response Body

Counts for the filtered responses

application/json
  1. response
  1. response
  2. …
total*integer
engines*array<>
days*array<>
Example Request
curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/responses/overview'
Example Response
{  "total": 0,  "engines": [    {      "engine": "string",      "responses": 0    }  ],  "days": [    {      "day": "string",      "engine": "string",      "responses": 0    }  ]}

List responses GET

List a brand's analysed responses, filtered, sorted and paged.

Get response GET

Get one response with its answer, mentions and citations.

Start free trial
Start free trial
Example Request
curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/responses/overview'
{
  "total": 0,
  "engines": [
    {
      "engine": "string",
      "responses": 0
    }
  ],
  "days": [
    {
      "day": "string",
      "engine": "string",
      "responses": 0
    }
  ]
}