Reports

curl "https://app.ranked.ai/api/v1/projects/{projectId}/reports" \
  -H "Authorization: Bearer rk_live_your_api_key"

GET

projects

{projectId}

reports

curl "https://app.ranked.ai/api/v1/projects/{projectId}/reports" \
  -H "Authorization: Bearer rk_live_your_api_key"

GET - List reports

string

required

Project UUID

number

default:"50"

Max reports to return

number

default:"0"

Number to skip

curl "https://app.ranked.ai/api/v1/projects/{projectId}/reports" \
  -H "Authorization: Bearer rk_live_your_api_key"

POST - Create a report

Requires a Read + Write API key.

string

required

Report title

string

required

7days, 30days, 90days, or custom

string

Start date (ISO 8601). Required when date_range is custom.

string

End date (ISO 8601). Required when date_range is custom.

string

Optional report description

curl -X POST "https://app.ranked.ai/api/v1/projects/{projectId}/reports" \
  -H "Authorization: Bearer rk_live_your_write_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Monthly SEO Report",
    "date_range": "30days"
  }'

curl -X POST "https://app.ranked.ai/api/v1/projects/{projectId}/reports" \
  -H "Authorization: Bearer rk_live_your_write_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Q1 2026 Report",
    "date_range": "custom",
    "custom_start_date": "2026-01-01",
    "custom_end_date": "2026-03-31"
  }'

Overview

Projects

Keywords

AI Visibility

Audits

Backlinks

Content

Webhooks

Reports

GET - List reports

POST - Create a report

​GET - List reports

​POST - Create a report

GET - List reports

POST - Create a report