Domain Citations Over Time

Get domain citation frequency over time for top domains

GET /citations/domains-over-time

Domain Citations Over Time

cURL

curl --request GET \
  --url https://server.promptwatch.com/api/v1/citations/domains-over-time \
  --header 'X-API-Key: <api-key>'

200

{
  "dates": [
    "2023-11-07T05:31:56Z"
  ],
  "series": [
    {
      "domain": "<string>",
      "data": [
        123
      ],
      "total": 123,
      "percentage": 123,
      "averageRank": 123
    }
  ],
  "totalCitations": 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

range · enum<string> · default: DAILY

Time range grouping

Available options: DAILY, WEEKLY, MONTHLY

granularity · enum<string> · default: daily

Time granularity for grouping data

Available options: daily, weekly, monthly

domainLimit · integer · default: 10

Maximum number of domains to include (for domain over time endpoint)

Required range: 1 <= x <= 50

domains · string[]

Filter by specific domains

includeSelf · boolean · default: false

If true, always include the project's own brand domain (even with 0 citations)

Response

200

application/json

Default Response

dates · string<date-time>[] · required

Array of dates for the time series

series · object[] · required

Time series data for each domain

Show child attributes

totalCitations · number · required

Total citations across all domains