Skip to main content
GET
/
projects
curl https://app.ranked.ai/api/v1/projects \
  -H "Authorization: Bearer rk_live_your_api_key"
{
  "success": true,
  "data": [
    {
      "id": "40596405-c27c-4dfc-89e4-142c87846d66",
      "name": "Sioux City Tree Co",
      "status": "active",
      "serviceType": "seo",
      "websiteUrl": "https://siouxcitytreeco.com",
      "createdAt": "2025-08-28T08:47:05.816Z"
    }
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "limit": 50,
      "offset": 0,
      "has_more": false
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://dev.ranked.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns active SEO projects owned by the API key holder. Only projects with trial, active, or past_due status are included.

Query parameters

limit
number
default:"50"
Maximum number of projects to return (max: 500)
offset
number
default:"0"
Number of projects to skip for pagination
curl https://app.ranked.ai/api/v1/projects \
  -H "Authorization: Bearer rk_live_your_api_key"
{
  "success": true,
  "data": [
    {
      "id": "40596405-c27c-4dfc-89e4-142c87846d66",
      "name": "Sioux City Tree Co",
      "status": "active",
      "serviceType": "seo",
      "websiteUrl": "https://siouxcitytreeco.com",
      "createdAt": "2025-08-28T08:47:05.816Z"
    }
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "limit": 50,
      "offset": 0,
      "has_more": false
    }
  }
}