Trends
Prompt visibility per day, week or month, with brands ranked by position.
apiKeyx-api-key<token>Workspace API key from Settings > API keys. Also accepted as Authorization: Bearer gsk_...
brandId*stringuuidengines?stringComma-separated engine slugs
length <= 500types?stringComma-separated prompt types
length <= 200intents?stringComma-separated prompt intents
length <= 200q?stringMatches prompt text
length <= 200from?stringAnswered on or after this UTC date; omit for all time
^\d{4}-\d{2}-\d{2}$to?stringAnswered on or before this UTC date; omit for today
^\d{4}-\d{2}-\d{2}$cadence?string"day""day""week""month"order?stringBy average visibility over the range
"desc""asc""desc"page?integer1 <= value1pageSize?integer1 <= value <= 20025One page of prompts with a visibility value per bucket
application/jsoncadence*stringCadence used; day falls back to week past 92 days
"day""week""month"buckets*array<string>UTC start date of each bucket
items*array<>total*integerpage*integerpageSize*integerbrands*array<>curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/trends/prompts'{ "cadence": "day", "buckets": [ "string" ], "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "text": "string", "type": "string", "intent": "string", "countryCode": "string", "visibility": 0, "responses": 0, "cells": [ 0 ], "ranking": [ { "key": "string", "position": 0, "mentions": 0 } ] } ], "total": 0, "page": 0, "pageSize": 0, "brands": [ { "key": "string", "name": "string", "domain": "string", "logoUrl": "string", "isBrand": true } ]}curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/trends/prompts'{
"cadence": "day",
"buckets": [
"string"
],
"items": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"text": "string",
"type": "string",
"intent": "string",
"countryCode": "string",
"visibility": 0,
"responses": 0,
"cells": [
0
],
"ranking": [
{
"key": "string",
"position": 0,
"mentions": 0
}
]
}
],
"total": 0,
"page": 0,
"pageSize": 0,
"brands": [
{
"key": "string",
"name": "string",
"domain": "string",
"logoUrl": "string",
"isBrand": true
}
]
}