Citations
Top cited URLs with daily average position and citation rate.
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"Up to 10 URLs with daily series
application/jsontotal*integerCitations in scope
days*array<string>urls*array<>brands*array<>curl -X GET 'https://app.gensiv.com/api/v1/brands/497f6eca-6276-4993-bfeb-53cbbbba6f08/citations/positions'{ "total": 0, "days": [ "string" ], "urls": [ { "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, "positions": [ 0 ], "rates": [ 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/positions'{
"total": 0,
"days": [
"string"
],
"urls": [
{
"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,
"positions": [
0
],
"rates": [
0
]
}
],
"brands": [
{
"key": "string",
"name": "string",
"domain": "string",
"logoUrl": "string",
"isBrand": true
}
]
}