Citations report

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
  }'

// 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);

# 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"])

{
  "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
    }
  ]
}

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
  }'

// 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);

# 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"])

{
  "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
    }
  ]
}

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

string

required

The site’s id, from List sites.

string

required

Inclusive day, YYYY-MM-DD, UTC.

string

required

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

enum<string>

default:"domain"

One of: domain, page.

enum<string>[]

default:[]

Any of: date, platform, prompt.

enum<string>[]

default:["answers","citations","citation_share"]

Any of: answers, citations, citation_share.

object

Fields platform, prompt, category, domain, owner, source_kind. See Filtering.

integer

default:50

Rows per page, 1–100.

string

Opaque cursor from info.next_cursor.

Response

object

Show properties

integer

Rows in this page.

integer

Rows across all pages.

string

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

string

object[]

Show properties

string

object

Show properties

string

Present when entity is domain.

string

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

enum<string>

One of: own, competitor, third_party.

string

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

integer

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

integer

Every link to it, counted separately.

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

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
  }'

// 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);

# 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"])

{
  "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
    }
  ]
}

Get started

Discovery

Prompts

Reports

Agent Analytics

Action Center

Body

Response

​Body

​Response

Body

Response