Get citations

Returns citations data for the specified brand in one of three modes:

• citations (default): AI Search citations with aggregates (top domains/competitors)
• search-queries: Search queries that return citations, with prompts and citation lists
• knowledge: Raw knowledge base citations with rich metadata

Supports filtering by date range, domain, and search query text. Results are paginated with cursor-based pagination.

GET /get-citations

Get citations

cURL

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

200

citations_mode

{
  "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

Pattern: ^[0-9a-fx]{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.

Pattern: ^\d{4}-\d{2}-\d{2}$

end_date · string<date>

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

Pattern: ^\d{4}-\d{2}-\d{2}$

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

200

application/json

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

pagination · object · required

Show child attributes

summary · object | null

Top aggregates (only included when no filters applied)

Show child attributes