> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rankraft.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Citations report

> POST /v1/reports/citations

Which domains or pages the engines linked to in answers to your prompts, who owns them (you, a competitor, a third party) and what kind of site they are. Ranked by the number of answers citing each one.

## Body

**site\_id** `string` *required*

The site's id, from [List sites](/api-reference/endpoints/list-sites).

**start\_date** `string` *required*

Inclusive day, `YYYY-MM-DD`, UTC.

**end\_date** `string` *required*

Inclusive day, `YYYY-MM-DD`, UTC. At most 92 days after `start_date`.

**entity** `enum\<string\>` (default: domain)

One of: `domain`, `page`.

**group\_by** `enum\<string\>[]`

Any of: `date`, `platform`, `prompt`.

**metrics** `enum\<string\>[]`

Any of: `answers`, `citations`, `citation_share`.

**filter** `object`

Fields `platform`, `prompt`, `category`, `domain`, `owner`, `source_kind`. See [Filtering](/api-reference/filtering).

**limit** `integer` (default: 50)

Rows per page, 1–100.

**cursor** `string`

Opaque cursor from `info.next_cursor`.

## Response

**info** `object`

**properties**

**count** `integer`

Rows in this page.

**total\_results** `integer`

Rows across all pages.

**next\_cursor** `string`

Pass as `cursor` for the next page; null on the last page.

**site\_id** `string`

**start\_date** `string`

**end\_date** `string`

**data** `object[]`

**properties**

**date** `string`

**platform** `string`

**prompt** `object`

**properties**

**id** `string`

**text** `string`

**domain** `string`

Present when `entity` is `domain`.

**page** `string`

Present when `entity` is `page`: the cited URL, with tracking parameters removed.

**owner** `enum\<string\>`

One of: `own`, `competitor`, `third_party`.

**source\_kind** `string`

forum, video, review, roundup, editorial, marketplace, reference, social, publishing, recipe, brand or unknown.

**rank** `integer`

**answers** `integer`

Distinct answers citing it. One page linked twice in an answer is one answer.

**citations** `integer`

Every link to it, counted separately.

**citation\_share** `number`

0–1: its share of all citations in the same group.

```bash cURL theme={"system"}
curl -X POST https://api.rankraft.ai/v1/reports/citations \
  -H "X-API-Key: $RANKRAFT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-01",
    "end_date": "2026-09-30",
    "entity": "domain",
    "filter": { "field": "owner", "op": "not_is", "value": "own" },
    "limit": 20
  }'
```

```javascript JavaScript theme={"system"}
// npm install rankraft-js · https://www.npmjs.com/package/rankraft-js
import { RankRaft, f } from "rankraft-js";

const rr = new RankRaft(); // reads RANKRAFT_API_KEY

const page = await rr.reports.citations({
  site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
  start_date: "2026-09-01",
  end_date: "2026-09-30",
  entity: "domain",
  filter: f.not_is("owner", "own"),
  limit: 20,
});
for (const row of page.data) console.log(row.rank, row.domain, row.owner, row.citation_share);
```

```python Python theme={"system"}
# pip install rankraft-py · https://pypi.org/project/rankraft-py/
from rankraft import RankRaft, F

with RankRaft() as rr:  # reads RANKRAFT_API_KEY
    page = rr.reports.citations(
        site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
        start_date="2026-09-01",
        end_date="2026-09-30",
        entity="domain",
        filter=F("owner").not_is("own"),
        limit=20,
    )
    for row in page:
        print(row["rank"], row["domain"], row["owner"], row["citation_share"])
```

```json 200 theme={"system"}
{
  "info": {
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-01",
    "end_date": "2026-09-30",
    "count": 2,
    "total_results": 38,
    "next_cursor": "eyJvIjoyMC…"
  },
  "data": [
    {
      "domain": "daraz.pk",
      "owner": "third_party",
      "source_kind": "marketplace",
      "rank": 1,
      "answers": 21,
      "citations": 26,
      "citation_share": 0.1182
    },
    {
      "domain": "reddit.com",
      "owner": "third_party",
      "source_kind": "forum",
      "rank": 2,
      "answers": 9,
      "citations": 11,
      "citation_share": 0.05
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.