# 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`Try it

### Competitor Citation Gaps

Copy

cURL

```bash
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

```json
{
  "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-Key** `string` header required

API key for authentication. Get yours from the Indexly dashboard under Settings → API Access

## Path parameters

- **siteId** `string` required

Site ID (must belong to your organization). Get it from your Indexly dashboard.

## Query parameters

- **page** `integer`

Page number for pagination. Defaults to 1.

- **pageSize** `integer`

Number of results per page. Defaults to 20, max 100.

- **scope** `string` required

Scope of citations to analyze. Use 'competitors' to find gap citations.

- **viewType** `string` required

Group citations. Use 'url'.

- **filter** `string`

Filter type. Use 'gap' to only show competitor citations that your brand lacks.

- **aiModelName** `string`

Filter citations by a specific AI model (e.g., OPENAI, GOOGLE, PERPLEXITY).

## Response

- **200** `application/json`

Default Response

- **citations** `array` required — List of gap citation objects including url, domain, total citations, and average position.

- **pagination** `object` required — Pagination details containing page, pageSize, total documents, and totalPages.

- **lastCalculatedAt** `string` — ISO date indicating when the citation analysis was last computed.