Skip to main content
GET
/
citations
/
top-pages
Top Cited Pages
curl --request GET \
  --url https://server.promptwatch.com/api/v1/citations/top-pages \
  --header 'X-API-Key: <api-key>'
[
  {
    "url": "<string>",
    "count": 123,
    "averageRank": 123
  }
]

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)

​
endDate
string<date>

End date for citation data (YYYY-MM-DD)

​
model
string

Filter by specific LLM model

​
promptId
string

Filter by specific prompt ID

​
llmMonitorId
string

Filter by specific LLM monitor ID

​
promptTypes
enum<string>[]

Filter by prompt type

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

Maximum number of results to return

Required range: 1 <= x <= 100
​
domains
string[]

Filter by specific domains

Response

Default Response

​
url
string
required

URL that was cited

​
count
number
required

Number of times this URL was cited

​
averageRank
number | null
required

Average rank/position for this URL