Citations
Cited URLs with types, models, share and positions.
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"citations""citations""share""average""best""worst"order?string"desc""asc""desc"page?integer1 <= value1pageSize?integer1 <= value <= 10025One page of cited URLs
application/jsonitems*array<>total*integerpage*integerpageSize*integerresponses*integerbrands*array<>curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/citations/urls'{ "items": [ { "pageId": "347b9bf8-fe00-46f6-b8ca-1e06b3bd5809", "url": "string", "title": "string", "domain": "string", "sourceType": "string", "contentType": "string", "owner": "brand", "brandKey": "string", "engines": [ "string" ], "citations": 0, "share": 0, "average": 0, "best": 0, "worst": 0 } ], "total": 0, "page": 0, "pageSize": 0, "responses": 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/urls'{
"items": [
{
"pageId": "347b9bf8-fe00-46f6-b8ca-1e06b3bd5809",
"url": "string",
"title": "string",
"domain": "string",
"sourceType": "string",
"contentType": "string",
"owner": "brand",
"brandKey": "string",
"engines": [
"string"
],
"citations": 0,
"share": 0,
"average": 0,
"best": 0,
"worst": 0
}
],
"total": 0,
"page": 0,
"pageSize": 0,
"responses": 0,
"brands": [
{
"key": "string",
"name": "string",
"domain": "string",
"logoUrl": "string",
"isBrand": true
}
]
}