Get Citations by Domain

Retrieve citation data grouped by domain with pagination.

GET /ai-analytics-service/api/public/v1/analytics/citations/domains

Get Citations by Domain

cURL

curl --request GET \
  --url https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations/domains \
  --header 'Authorization: <authorization>'

200

{
  "data": [
    {
      "domain": "<string>",
      "citations": 123,
      "citationsDelta": 123,
      "uniqueUrls": 123,
      "avgRank": 123,
      "platforms": [
        "<string>"
      ],
      "category": "<string>"
    }
  ],
  "pagination": {
    "total": 123,
    "limit": 123,
    "offset": 123,
    "hasMore": true
  }
}

Returns citation data grouped by domain. Each domain entry includes citation count, unique URLs, average rank, and category. Results are paginated and include period-over-period deltas.

Parameters

Authorization · string · required

Bearer token. Format: Bearer slat_<your-token>.

dateRange · integer

Number of days for the analysis window.

from · string

Start of date range. ISO 8601 format.

to · string

End of date range. ISO 8601 format.

brandId · number

Brand ID. Optional — if omitted, uses the workspace’s default brand.

topicId · number

Filter by topic ID.

platforms · string[]

Filter by one or more platforms.

category · string

Filter by citation category (e.g., OWNED, EARNED, COMPETITOR).

search · string

Search domains by name. Case-insensitive partial match.

region · string

Filter by ISO country code.

limit · integer

Number of results per page. Default: 20. Maximum: 100.

offset · integer

Number of results to skip. Default: 0.

promptId · number

Filter by a single prompt ID.

promptIds · number[]

Filter by multiple prompt IDs. Maximum 10 values.

Response

Returns 200 OK with a paginated list of domain citation data.

data · object[] · required

Array of domain citation objects.

Show citation domain object

domain · string · required

Domain name.

citations · integer · required

Total citation count.

citationsDelta · integer · required

Change from previous period.

uniqueUrls · integer · required

Number of unique URLs from the domain.

avgRank · number · required

Average citation rank.

platforms · string[] · required

Platforms that cited the domain.

category · string · required

Citation category.

pagination · object · required

Pagination metadata.

Show pagination object

total · integer · required

Total number of domains.

limit · integer · required

Results per page.

offset · integer · required

Current offset.

hasMore · boolean · required

Whether more results are available.

Example

cURL

curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations/domains?dateRange=30&topicId=42&limit=10" \
  -H "Authorization: Bearer slat_YOUR_TOKEN"

Response

{
  "data": [
    {
      "domain": "example.com",
      "citations": 45,
      "citationsDelta": 5,
      "uniqueUrls": 12,
      "avgRank": 2.3,
      "platforms": ["CHATGPT", "PERPLEXITY"],
      "category": "OWNED"
    },
    {
      "domain": "techreview.com",
      "citations": 30,
      "citationsDelta": -2,
      "uniqueUrls": 8,
      "avgRank": 3.1,
      "platforms": ["CHATGPT", "GEMINI"],
      "category": "EARNED"
    }
  ],
  "pagination": {
    "total": 45,
    "limit": 10,
    "offset": 0,
    "hasMore": true
  }
}

Status codes

Status	Description
200	Domain citations returned.
400	promptIds exceeds maximum of 10 values.
401	Missing or invalid Bearer token. See Authentication.
500	Internal server error.

What’s next

• Get Citations for Domain — Drill into URLs for a specific domain.
• Get Citations by URL — View all cited URLs.