Citations
Single citations with model, position and date.
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 <= 200topics?stringComma-separated topic ids
length <= 2000countries?stringComma-separated ISO country codes, lowercase
length <= 1000competitors?stringComma-separated competitor ids; responses mentioning any
length <= 2000from?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}$q?stringMatches the URL or title
length <= 200own?stringtrue: only the brand's own domain
"true""false"sourceTypes?stringComma-separated: news, blog, corporate, directory, academic, government, wiki, forum, social, video, other
length <= 300contentTypes?stringComma-separated: product, landing, docs, article, news, opinion, listicle, how_to, review, comparison, discussion, video, other
length <= 300domains?stringComma-separated domains
length <= 2000domainMode?string"include""include""exclude"sort?string"date""date""position"order?string"desc""asc""desc"page?integer1 <= value1pageSize?integer1 <= value <= 10025One page of citations
application/jsonitems*array<>total*integerpage*integerpageSize*integerbrands*array<>curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/citations/rows'{ "items": [ { "responseId": "ed662de2-39c1-4e7d-a6bf-6980511adfaf", "promptId": "b5415d63-4390-40ec-8c2b-33a2db2f5c67", "promptText": "string", "pageId": "347b9bf8-fe00-46f6-b8ca-1e06b3bd5809", "url": "string", "title": "string", "domain": "string", "sourceType": "string", "contentType": "string", "owner": "brand", "brandKey": "string", "engine": "string", "position": 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/citations/rows'{
"items": [
{
"responseId": "ed662de2-39c1-4e7d-a6bf-6980511adfaf",
"promptId": "b5415d63-4390-40ec-8c2b-33a2db2f5c67",
"promptText": "string",
"pageId": "347b9bf8-fe00-46f6-b8ca-1e06b3bd5809",
"url": "string",
"title": "string",
"domain": "string",
"sourceType": "string",
"contentType": "string",
"owner": "brand",
"brandKey": "string",
"engine": "string",
"position": 0,
"answeredAt": "2019-08-24T14:15:22Z"
}
],
"total": 0,
"page": 0,
"pageSize": 0,
"brands": [
{
"key": "string",
"name": "string",
"domain": "string",
"logoUrl": "string",
"isBrand": true
}
]
}