Responses
List a brand's analysed responses, filtered, sorted and paged.
apiKeyx-api-key<token>Workspace API key from Settings > API keys. Also accepted as Authorization: Bearer gsk_...
brandId*stringuuidq?stringMatches the prompt or the answer text
length <= 200promptId?stringuuidpageId?stringOnly responses that cite this cited page
uuidengines?stringComma-separated engine slugs
length <= 500types?stringComma-separated prompt types, matched on the prompt's current type
length <= 200intents?stringComma-separated prompt intents, matched on the prompt's current intent
length <= 200from?stringAnswered on or after this UTC date
^\d{4}-\d{2}-\d{2}$to?stringAnswered on or before this UTC date
^\d{4}-\d{2}-\d{2}$citations?stringhas: at least one citation, none: no citations
"has""none"self?stringhas: cites the brand's own site, none: does not
"has""none"competitors?stringComma-separated competitor ids; matches responses that mention any of them
length <= 2000topics?stringComma-separated topic ids; matches responses whose prompt is in any of them
length <= 2000scores?stringComma-separated brand sentiment buckets: low (<30), mixed (30 to 49), fair (50 to 74), high (75 to 100)
length <= 100sort?string"date""date""visibility""sentiment"order?string"desc""asc""desc"page?integer1 <= value1pageSize?integer1 <= value <= 10010One page of responses with the tracked brands
application/jsonitems*array<>total*integerpage*integerpageSize*integerbrands*array<>curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/responses'{ "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "promptId": "b5415d63-4390-40ec-8c2b-33a2db2f5c67", "promptText": "string", "engine": "string", "status": "completed", "preview": "string", "visibilityScore": 0, "sentiment": 0, "brandMentioned": true, "mentions": [ { "key": "string", "position": 0, "mentions": 0 } ], "citations": { "brand": 0, "total": 0 }, "answeredAt": "2019-08-24T14:15:22Z" } ], "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/responses'{
"items": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"promptId": "b5415d63-4390-40ec-8c2b-33a2db2f5c67",
"promptText": "string",
"engine": "string",
"status": "completed",
"preview": "string",
"visibilityScore": 0,
"sentiment": 0,
"brandMentioned": true,
"mentions": [
{
"key": "string",
"position": 0,
"mentions": 0
}
],
"citations": {
"brand": 0,
"total": 0
},
"answeredAt": "2019-08-24T14:15:22Z"
}
],
"total": 0,
"page": 0,
"pageSize": 0,
"brands": [
{
"key": "string",
"name": "string",
"domain": "string",
"logoUrl": "string",
"isBrand": true
}
]
}