Citation Analysis
Competitor Citation Gaps
Find URLs where your competitors are cited but you are not. Useful to discover new AI visibility opportunities.
GET
/api/v1/citations/:siteIdCompetitor Citation Gaps
cURL
curl --request GET \ --url 'https://app.indexly.ai/api/v1/citations/SITE_ID?page=1&pageSize=20&scope=competitors&viewType=url&filter=gap' \ --header 'X-API-Key: YOUR_API_KEY'
Response
{
"citations": [
{
"url": "https://visible.seranking.com/blog/best-ai-visibility-tools",
"domain": "visible.seranking.com",
"totalCitations": 437,
"position": 1.7258064516129032,
"modelBreakdown": {
"OPENAI": 0,
"GOOGLE": 124,
"PERPLEXITY": 180,
"AIOVERVIEW": 9,
"GROK": 124,
"CLAUDE": 0
},
"statusCode": 200
}
],
"pagination": {
"page": 1,
"pageSize": 20,
"total": 10637,
"totalPages": 532
},
"lastCalculatedAt": "2026-03-17T08:38:34.458Z"
}Authorizations
X-API-Keystringheaderrequired
API key for authentication. Get yours from the Indexly dashboard under Settings → API Access
Path parameters
siteIdstringrequired
Site ID (must belong to your organization). Get it from your Indexly dashboard.
Query parameters
pageinteger
Page number for pagination. Defaults to 1.
pageSizeinteger
Number of results per page. Defaults to 20, max 100.
scopestringrequired
Scope of citations to analyze. Use 'competitors' to find gap citations.
viewTypestringrequired
Group citations. Use 'url'.
filterstringrequired
Filter type. Use 'gap' to only show competitor citations that your brand lacks.
aiModelNamestring
Filter citations by a specific AI model (e.g., OPENAI, GOOGLE, PERPLEXITY).
Response
200 application/jsonDefault Response
citationsarrayrequired— List of gap citation objects including url, domain, total citations, and average position.
paginationobjectrequired— Pagination details containing page, pageSize, total documents, and totalPages.
lastCalculatedAtstring— ISO date indicating when the citation analysis was last computed.