Get citations

Get citations

curl --request GET \
  --url https://api.trakkr.ai/get-citations \
  --header 'Authorization: Bearer <token>'

{
  "brand_id": "1749113348709x432280934699237400",
  "mode": "citations",
  "updated_at": "2025-11-03T01:42:25.502006+00:00",
  "summary": {
    "total_citations": 346,
    "top_domains": [
      {
        "domain": "runnersworld.com",
        "count": 161,
        "citation_share": 13.55
      },
      {
        "domain": "tomsguide.com",
        "count": 86,
        "citation_share": 7.24
      }
    ],
    "top_competitors": [
      {
        "competitor": "Hoka One One",
        "count": 437,
        "citation_share": 10.93
      },
      {
        "competitor": "ASICS",
        "count": 426,
        "citation_share": 10.66
      }
    ]
  },
  "citations": [
    {
      "url": "https://www.runnersworld.com/best-running-shoes/",
      "domain": "runnersworld.com",
      "times_cited": 22,
      "first_seen": "2025-10-03T11:53:27.751253+00:00",
      "last_seen": "2025-10-28T01:40:50.681897+00:00",
      "competitors_referenced": [
        "Adidas",
        "Hoka One One"
      ],
      "prompts": [
        "best running shoes for marathon"
      ],
      "search_queries": [
        {
          "query": "best marathon shoes 2025",
          "count": 5
        }
      ],
      "sentiment": 75,
      "domain_rating": 85,
      "page_authority": 78,
      "topics": [
        "running",
        "marathon training"
      ],
      "h1": "Best Running Shoes 2025",
      "mentions_brand": true
    }
  ],
  "pagination": {
    "limit": 100,
    "has_more": true,
    "next_cursor": "MTA="
  }
}

GET

get-citations

Get citations

curl --request GET \
  --url https://api.trakkr.ai/get-citations \
  --header 'Authorization: Bearer <token>'

{
  "brand_id": "1749113348709x432280934699237400",
  "mode": "citations",
  "updated_at": "2025-11-03T01:42:25.502006+00:00",
  "summary": {
    "total_citations": 346,
    "top_domains": [
      {
        "domain": "runnersworld.com",
        "count": 161,
        "citation_share": 13.55
      },
      {
        "domain": "tomsguide.com",
        "count": 86,
        "citation_share": 7.24
      }
    ],
    "top_competitors": [
      {
        "competitor": "Hoka One One",
        "count": 437,
        "citation_share": 10.93
      },
      {
        "competitor": "ASICS",
        "count": 426,
        "citation_share": 10.66
      }
    ]
  },
  "citations": [
    {
      "url": "https://www.runnersworld.com/best-running-shoes/",
      "domain": "runnersworld.com",
      "times_cited": 22,
      "first_seen": "2025-10-03T11:53:27.751253+00:00",
      "last_seen": "2025-10-28T01:40:50.681897+00:00",
      "competitors_referenced": [
        "Adidas",
        "Hoka One One"
      ],
      "prompts": [
        "best running shoes for marathon"
      ],
      "search_queries": [
        {
          "query": "best marathon shoes 2025",
          "count": 5
        }
      ],
      "sentiment": 75,
      "domain_rating": 85,
      "page_authority": 78,
      "topics": [
        "running",
        "marathon training"
      ],
      "h1": "Best Running Shoes 2025",
      "mentions_brand": true
    }
  ],
  "pagination": {
    "limit": 100,
    "has_more": true,
    "next_cursor": "MTA="
  }
}

Authorizations

Authorization

string

header

required

API key authentication. Include your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

Query Parameters

brand

string

required

The brand ID (32-character hexadecimal string)

Required string length: 32

mode

enum<string>

default:citations

Citation mode to use:

citations - AI Search citations with aggregates
search-queries - Search queries with associated citations
knowledge - Knowledge base citations

Available options:

citations,

search-queries,

knowledge

start_date

string<date>

Filter by last seen date (YYYY-MM-DD). Only applies to citations and search-queries modes.

end_date

string<date>

Filter by last seen date (YYYY-MM-DD). Only applies to citations and search-queries modes.

domain

string

Filter citations by domain (substring match)

query

string

Filter search queries by query text (substring match). Only applies to search-queries mode.

limit

integer

default:100

Number of items per page (1-500)

Required range: 1 <= x <= 500

cursor

string

Pagination cursor from previous response

Response

Successful response

Option 1
Option 2
Option 3

brand_id

string

required

The brand ID

Example:

"1749113348709x432280934699237400"

mode

enum<string>

required

Response mode

Available options:

citations

Example:

"citations"

updated_at

string<date-time>

required

When the snapshot was last updated

Example:

"2025-11-03T01:42:25.502006+00:00"

citations

object[]

required

Array of citation items

Show child attributes

citations.url

string

required

Citation URL

Example:

"https://www.runnersworld.com/best-running-shoes/"

citations.domain

string

required

Domain of the citation

Example:

"runnersworld.com"

citations.times_cited

integer

required

Number of times this citation appeared

Example:

22

citations.first_seen

string<date-time>

required

First time this citation was seen

Example:

"2025-10-03T11:53:27.751253+00:00"

citations.last_seen

string<date-time>

required

Last time this citation was seen

Example:

"2025-10-28T01:40:50.681897+00:00"

citations.prompts

string[]

required

Original prompts that led to this citation

Example:

["best running shoes for marathon"]

citations.search_queries

object[]

required

Search queries that returned this citation

Show child attributes

citations.search_queries.query

string

Example:

"best marathon shoes 2025"

citations.search_queries.count

integer

Number of times this query returned this citation

Example:

5

citations.competitors_referenced

string[]

Competitors mentioned in this citation

Example:

["Adidas", "Hoka One One"]

citations.sentiment

integer | null

Sentiment score (0-100, higher is more positive)

Required range: 0 <= x <= 100

Example:

75

citations.domain_rating

integer | null

Domain authority rating

Required range: 0 <= x <= 100

Example:

85

citations.page_authority

integer | null

Page authority rating

Required range: 0 <= x <= 100

Example:

78

citations.topics

string[] | null

Key topics extracted from citation

Example:

["running", "marathon training", "footwear"]

citations.h1

string | null

Page H1 or title

Example:

"Best Running Shoes 2025"

citations.mentions_brand

boolean | null

Whether the citation explicitly mentions the brand

Example:

true

pagination

object

required

Show child attributes

pagination.limit

integer

required

Items per page

Example:

100

pagination.has_more

boolean

required

Whether more results exist

Example:

true

pagination.next_cursor

string | null

required

Cursor for next page (null if no more results)

Example:

"MTA="

summary

object

Top aggregates (only included when no filters applied)

Show child attributes

summary.total_citations

integer

Total number of citations in snapshot

Example:

346

summary.top_domains

object[]

Top domains by citation count

Show child attributes

summary.top_domains.domain

string

Example:

"runnersworld.com"

summary.top_domains.count

integer

Example:

161

Percentage of total citations

Example:

13.55

summary.top_competitors

object[]

Top competitors referenced in citations

Show child attributes

summary.top_competitors.competitor

string

Example:

"Hoka One One"

summary.top_competitors.count

integer

Example:

437

Percentage of total competitor references

Example:

10.93

Get competitor data Get outreach data

⌘I

Getting Started

API Endpoints

Authorizations

Query Parameters

Response