Skip to main content
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

​
projectId
string
required
Project UUID
​
limit
number
default:"50"
Max reports to return
​
offset
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.
​
title
string
required
Report title
​
date_range
string
required
7days, 30days, 90days, or custom
​
custom_start_date
string
Start date (ISO 8601). Required when date_range is custom.
​
custom_end_date
string
End date (ISO 8601). Required when date_range is custom.
​
description
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"
  }'