Skip to main content
GET
Get top citation pages

Authorizations

Authorization
string
header
required

API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.

Path Parameters

projectId
string<uuid>
required

Query Parameters

windowDays
enum<integer>
default:30

Fixed rolling window in days. Supported values are 30 and 90. Defaults to 30.

Available options:
30,
90
cursor
string

Opaque cursor from the previous response.

pageSize
integer
default:25

Results per page. Capped at 100.

Required range: 1 <= x <= 100
limit
integer
default:25

The same setting as pageSize. Send either; both with different values returns 400.

Required range: 1 <= x <= 100

Optional prefix search within citation URLs and canonical domains.

sourceVertical
enum<string>

Optional source vertical scope. community covers Reddit, Hacker News, GitHub, Stack Overflow, Stack Exchange and Dev.to, including their subdomains.

Available options:
community,
social,
editorial,
reference,
government,
education,
commercial,
video,
marketplace,
nonprofit,
other
topicId
string<uuid>

Only citations recorded under this topic, by the id the topics list returns. A prompt moved to another topic keeps its earlier citations under the earlier topic.

promptId
string<uuid>

Only citations from this tracked prompt, by the id the prompts list returns.

platform
string

Only citations from this AI platform: chatgpt-search, perplexity, google-ai, google-ai-mode or bing-copilot-search, plus claude and xai-search where the account tracks them.

Required string length: 1 - 100

Response

Top citation pages

data
object
required
meta
object
required

Sent beside data on every successful response that returns data.