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/:siteId

Competitor 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/json

Default Response

citationsarrayrequiredList of gap citation objects including url, domain, total citations, and average position.
paginationobjectrequiredPagination details containing page, pageSize, total documents, and totalPages.
lastCalculatedAtstringISO date indicating when the citation analysis was last computed.