AI crawler report

curl -X POST https://api.rankraft.ai/v1/reports/bots \
  -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",
    "timezone": "Asia/Karachi",
    "group_by": ["bot_name"],
    "metrics": ["hits", "pages", "verified_share"]
  }'

// npm install rankraft-js · https://www.npmjs.com/package/rankraft-js
import { RankRaft } from "rankraft-js";

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

const rows = await rr.reports
  .bots({
    site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    start_date: "2026-09-01",
    end_date: "2026-09-30",
    timezone: "Asia/Karachi",
    group_by: ["bot_name"],
    metrics: ["hits", "pages", "verified_share"],
  })
  .all(); // every page
for (const row of rows) console.log(row.bot_name, row.hits, row.verified_share);

# pip install rankraft-py · https://pypi.org/project/rankraft-py/
from rankraft import RankRaft

with RankRaft() as rr:  # reads RANKRAFT_API_KEY
    page = rr.reports.bots(
        site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
        start_date="2026-09-01",
        end_date="2026-09-30",
        timezone="Asia/Karachi",
        group_by=["bot_name"],
        metrics=["hits", "pages", "verified_share"],
    )
    for row in page.all():  # every page
        print(row["bot_name"], row["hits"], row["verified_share"])

{
  "info": {
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-01",
    "end_date": "2026-09-30",
    "timezone": "Asia/Karachi",
    "count": 2,
    "total_results": 2,
    "next_cursor": null
  },
  "data": [
    { "bot_name": "GPTBot", "hits": 1840, "pages": 212, "verified_share": 0.99 },
    { "bot_name": "ClaudeBot", "hits": 960, "pages": 180, "verified_share": 0 }
  ]
}

curl -X POST https://api.rankraft.ai/v1/reports/bots \
  -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",
    "timezone": "Asia/Karachi",
    "group_by": ["bot_name"],
    "metrics": ["hits", "pages", "verified_share"]
  }'

// npm install rankraft-js · https://www.npmjs.com/package/rankraft-js
import { RankRaft } from "rankraft-js";

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

const rows = await rr.reports
  .bots({
    site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    start_date: "2026-09-01",
    end_date: "2026-09-30",
    timezone: "Asia/Karachi",
    group_by: ["bot_name"],
    metrics: ["hits", "pages", "verified_share"],
  })
  .all(); // every page
for (const row of rows) console.log(row.bot_name, row.hits, row.verified_share);

# pip install rankraft-py · https://pypi.org/project/rankraft-py/
from rankraft import RankRaft

with RankRaft() as rr:  # reads RANKRAFT_API_KEY
    page = rr.reports.bots(
        site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
        start_date="2026-09-01",
        end_date="2026-09-30",
        timezone="Asia/Karachi",
        group_by=["bot_name"],
        metrics=["hits", "pages", "verified_share"],
    )
    for row in page.all():  # every page
        print(row["bot_name"], row["hits"], row["verified_share"])

{
  "info": {
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-01",
    "end_date": "2026-09-30",
    "timezone": "Asia/Karachi",
    "count": 2,
    "total_results": 2,
    "next_cursor": null
  },
  "data": [
    { "bot_name": "GPTBot", "hits": 1840, "pages": 212, "verified_share": 0.99 },
    { "bot_name": "ClaudeBot", "hits": 960, "pages": 180, "verified_share": 0 }
  ]
}

AI crawler and search-bot hits from your own server logs, grouped by any of date, hour, bot, provider, bot type, path and page type. Needs an integration installed on the site. Spoofed hits — a request using GPTBot’s name from an address OpenAI does not publish — are left out unless your filter mentions verified.

Body

string

required

The site’s id, from List sites.

string

required

Inclusive day, YYYY-MM-DD, in timezone.

string

required

Inclusive day, YYYY-MM-DD, in timezone. At most 400 days after start_date.

string

default:"UTC"

IANA zone for date and hour buckets and for the day boundaries, e.g. Asia/Karachi.

enum<string>[]

default:[]

Up to 3 of: date, hour, bot_name, bot_provider, bot_type, path, page_type.

enum<string>[]

default:["hits","pages","verified_share"]

Any of: hits, pages, verified_share, error_hits, last_visit.

object

Fields bot_name, bot_provider, bot_type, verified, path, page_type. See Filtering.

object

Show properties

string

required

One of the requested group_by fields or metrics.

enum<string>

default:"desc"

One of: asc, desc.

integer

default:100

Rows per page, 1–500.

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

YYYY-MM-DDTHH:00 in the requested time zone.

string

e.g. GPTBot, ClaudeBot, PerplexityBot.

string

ai_assistant, ai_training, index or ai_agent.

string

blog_editorial, product_page, docs_support, landing_page, brand_about, pricing, ugc_page, technical_infra or other.

integer

Distinct paths requested.

0–1: share of hits from IP ranges the provider publishes. Providers that publish no ranges read 0.

integer

Hits answered with a 4xx or 5xx.

string

curl -X POST https://api.rankraft.ai/v1/reports/bots \
  -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",
    "timezone": "Asia/Karachi",
    "group_by": ["bot_name"],
    "metrics": ["hits", "pages", "verified_share"]
  }'

// npm install rankraft-js · https://www.npmjs.com/package/rankraft-js
import { RankRaft } from "rankraft-js";

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

const rows = await rr.reports
  .bots({
    site_id: "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    start_date: "2026-09-01",
    end_date: "2026-09-30",
    timezone: "Asia/Karachi",
    group_by: ["bot_name"],
    metrics: ["hits", "pages", "verified_share"],
  })
  .all(); // every page
for (const row of rows) console.log(row.bot_name, row.hits, row.verified_share);

# pip install rankraft-py · https://pypi.org/project/rankraft-py/
from rankraft import RankRaft

with RankRaft() as rr:  # reads RANKRAFT_API_KEY
    page = rr.reports.bots(
        site_id="3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
        start_date="2026-09-01",
        end_date="2026-09-30",
        timezone="Asia/Karachi",
        group_by=["bot_name"],
        metrics=["hits", "pages", "verified_share"],
    )
    for row in page.all():  # every page
        print(row["bot_name"], row["hits"], row["verified_share"])

{
  "info": {
    "site_id": "3f2c9a10-7b1e-4c55-9d2a-1a2b3c4d5e6f",
    "start_date": "2026-09-01",
    "end_date": "2026-09-30",
    "timezone": "Asia/Karachi",
    "count": 2,
    "total_results": 2,
    "next_cursor": null
  },
  "data": [
    { "bot_name": "GPTBot", "hits": 1840, "pages": 212, "verified_share": 0.99 },
    { "bot_name": "ClaudeBot", "hits": 960, "pages": 180, "verified_share": 0 }
  ]
}

Get started

Discovery

Prompts

Reports

Agent Analytics

Action Center

Body

Response

​Body

​Response

Body

Response