Skip to main content
GET
Citation Analytics

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours from the Promptwatch dashboard under Settings > API Keys.

Query Parameters

startDate
string<date>

Start date for citation data (YYYY-MM-DD). Max range 90 days.

endDate
string<date>

End date for citation data (YYYY-MM-DD). Max range 90 days.

models

Filter by LLM models. Repeat for multiple: models=x&models=y Single model

promptId
string

Filter by specific prompt ID

llmMonitorId
string

Filter by specific LLM monitor ID

promptTypes

Filter by prompt type. Repeat for multiple: promptTypes=ORGANIC&promptTypes=BRAND_SPECIFIC

Available options:
ORGANIC,
BRAND_SPECIFIC,
COMPETITOR_COMPARISON
limit
integer
default:20

Maximum number of domain results to return

Required range: 1 <= x <= 100
domains

Filter by domains. Repeat for multiple: domains=x&domains=y Single domain

page
integer
default:1

Page number for URL results (1-indexed)

Required range: x >= 1
size
integer
default:20

Number of URL results per page

Required range: 1 <= x <= 250

Response

Default Response

domains
object[]
required

Top cited domains with their citation counts

urls
object[]
required

Top cited URLs with their citation counts

totalEstimatedTraffic
number
required

Total estimated traffic from all cited URLs

summary
object
required
pagination
object
required
averageAuthorityScore
number | null

Average domain authority score of cited domains

averagePageRank
number | null

Average page rank of cited URLs