WWatchLLM
get/api/v2/citations

Return citation analytics for the selected project.

Return citation analytics for the selected project.

Requires bearer API key

Parameters

NameInDescription
X-Project-IdheaderRequired for organization-wide API keys on project-scoped endpoints. Project-scoped keys infer the project automatically.string
pagequeryNo description provided.integer
sizequeryNo description provided.integer
startDatequeryNo description provided.string:date-time
endDatequeryNo description provided.string:date-time
monitorIdsqueryComma-separated values are accepted.string
modelIdsqueryComma-separated values are accepted.string
queryquerySearch citation title, URL, domain, model, or prompt text. Alias: q.string
qqueryAlias for query.string
sourceTypequerySingle source type filter used by workspace source pages.string
sourceTypesqueryComma-separated source types are accepted.string
contentTypequerySingle content type filter used by workspace source pages.string
contentTypesqueryComma-separated content types are accepted.string
responsequeryFilter to citations extracted from one response. Alias: responseId.string
responseIdqueryAlias for response.string
selfqueryFilter self-citations or external citations.string (self, external)
domainqueryNo description provided.string
urlqueryPartial URL filter.string
granularityqueryNo description provided.string

Responses

200

Successful JSON response.

application/json
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "summary": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "totalCitations": {
          "type": "integer"
        },
        "uniqueDomains": {
          "type": "integer"
        },
        "selfCitationRate": {
          "type": "number"
        },
        "avgPerResponse": {
          "type": "number"
        },
        "avgRank": {
          "type": "number"
        }
      },
      "required": [
        "totalCitations",
        "uniqueDomains",
        "selfCitationRate",
        "avgPerResponse",
        "avgRank"
      ]
    },
    "topDomains": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "domain": {
            "type": "string"
          },
          "count": {
            "type": "integer"
          },
          "avgRank": {
            "type": "number"
          },
          "percentage": {
            "type": "number"
          }
        },
        "required": [
          "domain",
          "count",
          "avgRank",
          "percentage"
        ]
      }
    },
    "topUrls": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "url": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "count": {
            "type": "integer"
          },
          "avgRank": {
            "type": "number"
          }
        },
        "required": [
          "url",
          "domain",
          "count",
          "avgRank"
        ]
      }
    }
  },
  "required": [
    "summary",
    "topDomains",
    "topUrls"
  ]
}

Try it

Send this request to the local WatchLLM REST handler. Use a key from /workspace/api; organization keys can include X-Project-Id only when the endpoint documents that header.