Gaps & citations

List citation sources

The domains AI answers lean on for your prompts — yours, competitors', and everyone else's — ranked by how many prompts they cost you.

GEThttps://api.vidrys.com/v1/projects/{project_id}/citations

Plan: Grow and above
Key: read
Rate cost: 1 unit
MCP tool: list_citation_sources

curl --request GET \
  --url "https://api.vidrys.com/v1/projects/{project_id}/citations?page_size=50" \
  --header "Authorization: Bearer $VIDRYS_API_KEY"

200 · success

{
  "domains": [
    {
      "domain": "g2.com",
      "kind": "third_party",
      "citations": 34,
      "lost_prompts": 11
    },
    {
      "domain": "northwindbilling.com",
      "kind": "competitor",
      "citations": 22,
      "lost_prompts": 8
    },
    {
      "domain": "acmeinvoicing.com",
      "kind": "own",
      "citations": 17,
      "lost_prompts": 2
    }
  ],
  "trend": [
    {
      "date": "2026-09-20",
      "own": 17,
      "competitor": 46,
      "third_party": 154
    }
  ],
  "page": {
    "page": 1,
    "page_size": 50,
    "total": 38
  }
}

Authorization

Sent as a header on every request.

Authorizationstringrequired

A Vidrys API key, sent as Bearer vidrys_sk_…. A read key is enough. See Authentication.

Path parameters

project_idstringrequired

The project's id, from List projects.

Query parameters

pageintegerdefault 1

Page number, from 1.

page_sizeintegerdefault 50

Rows per page, 1–100.

Response · 200

application/json

domainsobject[]

Cited domains, the ones behind the most lost prompts first.

+Show child attributes

domainstring

The domain, without www..

kindstring

Whose it is. A domain can appear once per kind.

Values:owncompetitorthird_party

citationsinteger

Cited URLs on this domain.

lost_promptsinteger

Prompts where an answer cited it and the brand lost.

trendobject[]

Cumulative citations by kind at each snapshot, oldest first.

+Show child attributes

datestring

Day, as YYYY-MM-DD.

owninteger

Citations of the brand's domains, running total.

competitorinteger

Citations of competitors' domains, running total.

third_partyinteger

Citations of other domains, running total.

pageobject

Where these rows sit in the full list.

+Show child attributes

pageinteger

This page's number, from 1.

page_sizeinteger

Rows per page.

totalinteger

Rows across every page.

Errors

404 not_found	The project or item doesn't exist in this workspace. A project from another workspace also returns 404, never 403.
422 invalid_request	A parameter or body field is missing or has the wrong type or value. The message names the field. Also returned when a write would pass the plan's prompt limit.
401 unauthorized	No key was sent, or the key is unknown, revoked or expired, or the member who created it has left the workspace or been deactivated.
402 plan_required	The workspace's plan doesn't include API access. It's included on Grow, Scale and Custom.
403 workspace_not_approved	The workspace is still waiting for approval, or wasn't approved.
429 rate_limited	Too many requests this minute. Wait for the number of seconds in the `Retry-After` header, then retry.

Every code, and what to retry, is in Errors.