Citation history for a cited URL
Authorizations
Provide your API key as a Bearer token: Authorization: Bearer YOUR_API_KEY.
Path Parameters
Brand report identifier.
1"01HX7K2YV9D3M8N0G6Q5R4S3T2"
Query Parameters
Cited URL to fetch the citation history for. URL-encoded.
1"https://example.com/guides/best-flat-feet-running-shoes"
Start date for the lookup window (inclusive).
1"2025-01-01"
End date for the lookup window (inclusive).
1"2025-01-31"
Country code to filter by. Lowercase ISO 3166-1 alpha-2; use uk for the United Kingdom.
1"us"
Optional. AI engine(s) to filter by. Repeat the param or pass a single value.
chatgpt, google, perplexity, copilot, google_ai_mode, gemini, claude "chatgpt"
Optional. Filter the citation history by tag id.
Response
Citation totals (current vs previous period) and daily history for the given URL.
Total citations for the URL across the window.
Total citations for the URL across the immediately-preceding window of equal length.
Percentage change vs the previous period (rounded to one decimal). +100 when growing from zero.