Get Citations for Domain

Retrieve individual cited URLs for a specific domain.

GET /ai-analytics-service/api/public/v1/analytics/citations/domains/{domain}/urls

Get Citations for Domain

cURL

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

200

{
  "urls": [
    {
      "urlHash": "<string>",
      "url": "<string>",
      "title": "<string>",
      "domain": "<string>",
      "citations": 123,
      "citationsDelta": 123,
      "runsCount": 123,
      "avgRank": 123,
      "category": "<string>",
      "platforms": [
        "<string>"
      ]
    }
  ]
}

Returns citation data for URLs belonging to a specific domain. Use this to drill into which pages from a domain are being cited by AI platforms.

Parameters

domain · string · required

Domain name to retrieve citations for (e.g., example.com).

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 URLs by text. Case-insensitive partial match.

region · string

Filter by ISO country code.

limit · integer

Maximum number of results. 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 an array of citation URL objects for the domain.

urls · object[] · required

Array of citation URL objects.

Show citation URL object

urlHash · string · required

Unique hash for the URL.

url · string · required

Full URL.

title · string

Page title.

domain · string · required

Domain name.

citations · integer · required

Total citation count.

citationsDelta · integer · required

Change from previous period.

runsCount · integer · required

Number of query runs that cited the URL.

avgRank · number · required

Average citation rank.

category · string · required

Citation category.

platforms · string[] · required

Platforms that cited the URL.

Example

cURL

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

Response

[
  {
    "urlHash": "a1b2c3d4",
    "url": "https://example.com/pm-tools-comparison",
    "title": "Best Project Management Tools 2026",
    "domain": "example.com",
    "citations": 25,
    "citationsDelta": 3,
    "runsCount": 18,
    "avgRank": 1.8,
    "category": "OWNED",
    "platforms": ["CHATGPT", "PERPLEXITY", "GEMINI"]
  },
  {
    "urlHash": "e5f6g7h8",
    "url": "https://example.com/blog/remote-work-tips",
    "title": "Remote Work Best Practices",
    "domain": "example.com",
    "citations": 12,
    "citationsDelta": 1,
    "runsCount": 10,
    "avgRank": 3.2,
    "category": "OWNED",
    "platforms": ["CHATGPT"]
  }
]

Status codes

Status	Description
200	Domain URLs 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 by Domain — View all domains.
• Get Citations Summary — View citation totals and categories.