Domain Citations Over Time

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

import requests

url = "https://server.promptwatch.com/api/v2/citations/domains-over-time"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://server.promptwatch.com/api/v2/citations/domains-over-time', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://server.promptwatch.com/api/v2/citations/domains-over-time",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://server.promptwatch.com/api/v2/citations/domains-over-time"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://server.promptwatch.com/api/v2/citations/domains-over-time")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://server.promptwatch.com/api/v2/citations/domains-over-time")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "dates": [
    "2026-03-14T00:00:00.000Z",
    "2026-03-15T00:00:00.000Z"
  ],
  "series": [
    {
      "domain": "docs.example.com",
      "data": [
        12,
        15
      ],
      "total": 27,
      "percentage": 52,
      "averageRank": 2.1
    },
    {
      "domain": "competitor.example.net",
      "data": [
        8,
        7
      ],
      "total": 15,
      "percentage": 29,
      "averageRank": 3.4
    }
  ],
  "totalCitations": 52
}

GET

citations

domains-over-time

Domain Citations Over Time

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

import requests

url = "https://server.promptwatch.com/api/v2/citations/domains-over-time"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://server.promptwatch.com/api/v2/citations/domains-over-time', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://server.promptwatch.com/api/v2/citations/domains-over-time",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://server.promptwatch.com/api/v2/citations/domains-over-time"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://server.promptwatch.com/api/v2/citations/domains-over-time")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://server.promptwatch.com/api/v2/citations/domains-over-time")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "dates": [
    "2026-03-14T00:00:00.000Z",
    "2026-03-15T00:00:00.000Z"
  ],
  "series": [
    {
      "domain": "docs.example.com",
      "data": [
        12,
        15
      ],
      "total": 27,
      "percentage": 52,
      "averageRank": 2.1
    },
    {
      "domain": "competitor.example.net",
      "data": [
        8,
        7
      ],
      "total": 15,
      "percentage": 29,
      "averageRank": 3.4
    }
  ],
  "totalCitations": 52
}

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

promptId

string

Filter by specific prompt ID

llmMonitorId

string

Filter by specific LLM monitor ID

promptTypes

Filter by prompt type. Repeat for multiple

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

Filter by domains. Repeat for multiple

includeSelf

boolean

default:false

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

Response

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

Self-Citation Frequency Citation Rank Analysis

⌘I

Overview

API Reference

Changelog

Domain Citations Over Time

Authorizations

Query Parameters

Response