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

List prompts GET

List a brand's prompts, filtered, sorted and paged.

Get prompt insights GET

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

Gensiv

Resources

AcademyWebsiteBlogGlossary

Developer tools

API referenceMCP serverChangelog

Support

Contact supportGetting startedRate limits

© 2026 Gensiv. All rights reserved.

Prompts

Add prompts

POST
/brands/{brandId}/prompts

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

Authorization

apiKey write
headerx-api-key<token>

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

Scope: write

Path Parameters

brandId*string
Formatuuid

Request Body

application/json
  1. body
  1. body
  2. …
items*array<>
Items1 <= items <= 50
countryCode*|

Country code, or null for Global

Match^[a-z]{2}$
topicIds?array<>
Itemsitems <= 50
Default[]
tagIds?array<>
Itemsitems <= 50
Default[]

Response Body

Prompts added; repeats are skipped

application/json
  1. response
  1. response
  2. …
created*integer
skipped*integer

Prompts already tracked in that location, or repeated in the list

Example Request
curl -X POST 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/prompts' \  -H 'Content-Type: application/json' \  -d '{  "items": [    {      "text": "string"    }  ],  "countryCode": "string"}'
Example Response
{  "created": 0,  "skipped": 0}

List prompts GET

List a brand's prompts, filtered, sorted and paged.

Get prompt insights GET

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

Start free trial
Start free trial
Example Request
curl -X POST 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/prompts' \
  -H 'Content-Type: application/json' \
  -d '{
  "items": [
    {
      "text": "string"
    }
  ],
  "countryCode": "string"
}'
{
  "created": 0,
  "skipped": 0
}