Skip to content
TrakkrAPI

Get Citations

Get URLs that AI models cite when mentioning your brand. Understand your source authority.

Requires authentication
60 req/min

Endpoint

GET/get-citations

Returns URLs that AI models cite when mentioning your brand. Citations come from models with web search capabilities like Perplexity and SearchGPT.

Query Parameters

brand_idstringrequired

Brand UUID from /get-brands

viewstring

View mode: list, history, queries, sources, feed, heatmap

Default: list

limitinteger

Results per page (1-500)

Default: 100

offsetinteger

Pagination offset

Default: 0

domainstring

Filter by domain (partial match). Required when view=sources.

daysinteger

Historical period in days (7-365, for view=history)

Default: 30

days_backinteger

Days back for feed comparison (1-30, for view=feed)

Default: 7

tag_idsstring

Comma-separated tag UUIDs. Only returns citations from prompts with these tags.

prompt_textstring

Filter citations by prompt text (partial match)

This endpoint is rate limited to 60 requests per minute per API key. See the Rate Limits page for handling 429 responses.

Response Fields

Citation Object

idstring

Citation UUID

urlstring

Full URL of the cited page

domainstring

Domain name extracted from URL

page_titlestringnullable

Title of the cited page

prompt.textstring

The prompt that triggered this citation

prompt.typestring

Prompt intent type

metrics.appearancesinteger

Times this URL was cited

metrics.sentimentstring

AI sentiment: positive, neutral, negative

metrics.visibility_scorenumber

How prominently cited (0-100)

seo.domain_ratingnumber

Domain authority score (0-100)

source_typestring

Citation source: organic, paid, direct

search_modelstring

AI model that provided this citation

datestring

Date of the citation (YYYY-MM-DD)

Filter by Domain

Use the domain parameter to filter citations from a specific source:

GET /get-citations?brand_id=...&domain=techcrunch.com
The domain filter uses partial matching. techcrunch will matchtechcrunch.com and blog.techcrunch.com.

View Modes

Use the view parameter to access different citation data views. Omitting it (or passing view=list) returns the default paginated list above.

ViewDescription
listDefault. Paginated citation URLs.
historyTime series of citation counts, brand mentions, and sentiment.
queriesQuery-level analytics with intent clustering and gap analysis.
sourcesFull domain profile. Requires domain parameter.
feedChange feed: new, lost, and changed citations.
heatmapBrand vs competitors presence matrix across top domains.

view=history

Returns time series data for citation trends over a configurable period. Use the days parameter to control the lookback window (7-365, default 30).

Request
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-citations?brand_id=BRAND_ID&view=history&days=30'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "brand_time_series": [
4    {
5      "date": "2026-02-01",
6      "total_citations": 142,
7      "brand_mentions": 98,
8      "unique_sources": 67,
9      "avg_sentiment": 72.4
10    }
11  ],
12  "competitor_time_series": {
13    "Coda": [{ "date": "2026-02-01", "mentions": 45 }]
14  },
15  "snapshots_available": 8,
16  "date_range": { "start": "2026-02-01", "end": "2026-03-01" }
17}

Time Series Point

datestring

Date (YYYY-MM-DD)

total_citationsinteger

Total citation count

brand_mentionsinteger

Citations mentioning your brand

unique_sourcesinteger

Unique source domains

avg_sentimentnumbernullable

Average sentiment score (0-100)

view=queries

Returns query-level citation analytics: intent clusters, top/gap queries, and coverage rates. Use this to understand which search queries drive citations and where gaps exist.

Request
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-citations?brand_id=BRAND_ID&view=queries'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "clusters": [
4    {
5      "intent": "comparison",
6      "label": "Comparison Queries",
7      "queries": ["notion vs coda", "notion vs confluence"],
8      "total_citations": 24,
9      "brand_appears_in": 18,
10      "coverage_rate": 75.0
11    }
12  ],
13  "top_queries": [
14    {
15      "query": "best project management tools",
16      "intent": "recommendation",
17      "frequency": 12,
18      "citations_found": 8,
19      "brand_appears": true,
20      "top_sources": ["techcrunch.com", "g2.com"],
21      "competitors_appearing": ["Coda", "Confluence"],
22      "is_new": false,
23      "trend": "up"
24    }
25  ],
26  "gap_queries": [],
27  "coverage_by_intent": { "comparison": 75.0, "recommendation": 60.0 },
28  "new_queries_count": 3,
29  "rising_queries_count": 5
30}

Query Insight

querystring

The search query text

intentstring

Query intent: comparison, alternative, best_for, discovery, recommendation

frequencyinteger

How many times this query appeared

brand_appearsboolean

Whether your brand appears in results

top_sourcesarray

Top cited sources for this query

competitors_appearingarray

Competitors that appear for this query

is_newboolean

First seen in latest snapshot

trendstring

Trend direction: up, down, stable

view=sources

Returns a detailed profile for a specific source domain. The domain parameter is required and must be an exact domain match (e.g. techcrunch.com).

Request
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-citations?brand_id=BRAND_ID&view=sources&domain=techcrunch.com'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "domain": "techcrunch.com",
4  "total_citations": 45,
5  "unique_pages": 12,
6  "mentions_you": true,
7  "mention_count": 8,
8  "competitors_on_domain": ["Coda", "Confluence"],
9  "avg_sentiment": 74.2,
10  "pages": [
11    {
12      "url": "https://techcrunch.com/notion-review",
13      "h1": "Notion Review 2026",
14      "sentiment": 82,
15      "mentions_brand": true,
16      "competitors": ["Coda"],
17      "appearance_count": 5
18    }
19  ],
20  "first_seen": "2025-11-15",
21  "last_seen": "2026-03-01"
22}
Returns 400 if the domain parameter is not provided, or 404 if no citations exist for that domain.

view=feed

Returns a change feed comparing the current citation snapshot against a previous one. Use days_back to control how far back to compare (1-30, default 7). Events include new citations, lost citations, sentiment changes, and new competitor appearances.

Request
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-citations?brand_id=BRAND_ID&view=feed&days_back=7'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "events": [
4    {
5      "event_type": "new",
6      "url": "https://zapier.com/blog/notion-tips",
7      "domain": "zapier.com",
8      "h1": "10 Notion Tips for 2026",
9      "source_type": "earned_media",
10      "timestamp": "2026-03-01",
11      "mentions_brand": true,
12      "sentiment": 78,
13      "appearance_count": 3,
14      "prompts": ["best productivity tools"]
15    },
16    {
17      "event_type": "lost",
18      "url": "https://old-blog.com/notion",
19      "domain": "old-blog.com",
20      "timestamp": "2026-02-25"
21    }
22  ],
23  "current_snapshot_date": "2026-03-01",
24  "previous_snapshot_date": "2026-02-22",
25  "total_current": 250,
26  "total_previous": 245
27}

Feed Event

event_typestring

Event type: new, lost, sentiment_changed, competitor_appeared

urlstring

Citation URL

domainstring

Source domain

h1stringnullable

Page title

source_typestringnullable

Source classification

timestampstring

When the event occurred

sentimentintegernullable

Current sentiment (0-100)

prev_sentimentintegernullable

Previous sentiment (for sentiment_changed)

view=heatmap

Returns a competitive presence matrix showing which brands appear on which top domains. Useful for identifying citation coverage gaps relative to competitors.

Request
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-citations?brand_id=BRAND_ID&view=heatmap'
200 OK
1{
2  "brand": { "id": "...", "name": "Notion" },
3  "domains": ["techcrunch.com", "g2.com", "zapier.com"],
4  "brands": ["Notion", "Coda", "Confluence"],
5  "your_brand": "Notion",
6  "cells": [
7    { "domain": "techcrunch.com", "brand": "Notion", "is_present": true, "mention_count": 8 },
8    { "domain": "techcrunch.com", "brand": "Coda", "is_present": true, "mention_count": 3 }
9  ],
10  "your_coverage": 86.7,
11  "competitor_coverage": { "Coda": 60.0, "Confluence": 46.7 }
12}

Heatmap Cell

domainstring

Source domain

brandstring

Brand name

is_presentboolean

Whether this brand appears on this domain

mention_countinteger

Number of mentions on this domain

Use Cases

  • Identify which content is getting cited by AI
  • Find high-authority domains linking to your brand
  • Track citation trends over time with view=history
  • Discover content gaps with view=queries
  • Monitor citation changes in real-time with view=feed
  • Compare source coverage against competitors with view=heatmap

Code Example

Request
1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-citations?brand_id=75ffdeb9-0924-4ff9-8ded-c2470d73d224&limit=50'
200 OK
1{
2  "brand": {
3    "id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4    "name": "Notion"
5  },
6  "citations": [
7    {
8      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
9      "url": "https://techcrunch.com/notion-review",
10      "domain": "techcrunch.com",
11      "page_title": "Notion Review: The Best Workspace Tool for 2026",
12      "prompt": {
13        "text": "What are the best CRM tools for enterprise?",
14        "type": "commercial"
15      },
16      "metrics": {
17        "appearances": 5,
18        "sentiment": "positive",
19        "visibility_score": 85
20      },
21      "seo": {
22        "domain_rating": 92
23      },
24      "source_type": "organic",
25      "search_model": "gpt-4o",
26      "date": "2026-01-08"
27    }
28  ],
29  "pagination": {
30    "total": 250,
31    "limit": 50,
32    "offset": 0,
33    "has_more": true
34  }
35}
Press ? for keyboard shortcuts