Get Citations Summary

Retrieve citation totals, category breakdown, and trend data.

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

Get Citations Summary

cURL

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

200

{
  "totals": {
    "totalCitations": 123,
    "totalCitationsDelta": 123,
    "uniqueUrls": 123,
    "uniqueUrlsDelta": 123,
    "runsWithCitations": 123,
    "runsWithCitationsDelta": 123
  },
  "categories": [
    {
      "category": "<string>",
      "label": "<string>",
      "count": 123,
      "countDelta": 123,
      "pct": 123
    }
  ],
  "trend": [
    {
      "date": "<string>",
      "citations": 123,
      "uniqueUrls": 123,
      "ownedCitations": 123,
      "mentionedCitations": 123,
      "competitorCitations": 123,
      "socialCitations": 123,
      "otherCitations": 123,
      "notMentionedCitations": 123
    }
  ]
}

Returns a summary of citations referenced by AI platforms in their responses. Includes total counts with period-over-period deltas, a breakdown by category (owned, earned, competitor, etc.), and a daily citation trend.

Parameters

Authorization · string · required

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

dateRange · integer

Number of days for the analysis window (e.g., 7, 30, 90).

from · string

Start of date range. ISO 8601 format (e.g., 2026-02-01T00:00:00Z).

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: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

region · string

Filter by ISO country code for region.

promptId · number

Filter by a single prompt ID.

promptIds · number[]

Filter by multiple prompt IDs. Maximum 10 values.

Response

Returns 200 OK with the citations summary.

totals · object · required

Aggregate citation counts with period-over-period deltas.

Show totals object

totalCitations · integer · required

Total citation count.

totalCitationsDelta · integer · required

Change from previous period.

uniqueUrls · integer · required

Number of unique URLs cited.

uniqueUrlsDelta · integer · required

Change from previous period.

runsWithCitations · integer · required

Query runs that produced citations.

runsWithCitationsDelta · integer · required

Change from previous period.

categories · object[] · required

Citation breakdown by category.

Show category stat

category · string · required

Category key (e.g., OWNED, EARNED, COMPETITOR).

label · string · required

Display label for the category.

count · integer · required

Citation count in the category.

countDelta · integer · required

Change from previous period.

pct · number · required

Percentage of total citations.

trend · object[] · required

Daily citation trend.

Show trend point

date · string · required

Date. Format: YYYY-MM-DD.

citations · integer · required

Total citations on the date.

uniqueUrls · integer · required

Unique URLs cited.

ownedCitations · integer

Owned category citations.

mentionedCitations · integer

Mentioned category citations.

competitorCitations · integer

Competitor category citations.

socialCitations · integer

Social category citations.

otherCitations · integer

Other category citations.

notMentionedCitations · integer

Not-mentioned category citations.

Example

cURL

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

Response

{
  "totals": {
    "totalCitations": 450,
    "totalCitationsDelta": 35,
    "uniqueUrls": 120,
    "uniqueUrlsDelta": 10,
    "runsWithCitations": 180,
    "runsWithCitationsDelta": 15
  },
  "categories": [
    { "category": "OWNED", "label": "Owned", "count": 85, "countDelta": 8, "pct": 18.9 },
    { "category": "EARNED", "label": "Earned", "count": 150, "countDelta": 12, "pct": 33.3 },
    { "category": "COMPETITOR", "label": "Competitor", "count": 100, "countDelta": 5, "pct": 22.2 },
    { "category": "OTHER", "label": "Other", "count": 115, "countDelta": 10, "pct": 25.6 }
  ],
  "trend": [
    {
      "date": "2026-02-10",
      "citations": 15,
      "uniqueUrls": 8,
      "ownedCitations": 3,
      "mentionedCitations": 5,
      "competitorCitations": 4,
      "socialCitations": 1,
      "otherCitations": 2,
      "notMentionedCitations": 0
    }
  ]
}

Status codes

Status	Description
200	Citations summary 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 citations grouped by domain.
• Get Citations by URL — View individual cited URLs.