List Projects

List all SEO projects for the authenticated user

GEThttps://app.ranked.ai/api/v1/projects

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

Every project carries a productMode:

Value	Meaning
`managed`	Ranked AI's team does the work (content, publishing, optimization, outreach, Google Ads). The full software suite is included in the service plan and never billed separately.
`software`	Self-serve SEO Software: the account runs it themselves. Rank tracking, AI visibility prompts, audits, backlinks, heatmaps, integrations and reports, billed as prepaid keyword and prompt blocks. No content pipeline, so the content endpoints return nothing for these projects.

Query parameters

limitnumberdefault: 50

Maximum number of projects to return (max: 500)

offsetnumberdefault: 0

Number of projects to skip for pagination

product_modestring

Only return one kind of project: managed or software. Omit for both.

Request

curl "https://app.ranked.ai/api/v1/projects?product_mode=managed" \
  -H "Authorization: Bearer rk_live_your_api_key"

Response

{
  "success": true,
  "data": [
    {
      "id": "40596405-c27c-4dfc-89e4-142c87846d66",
      "name": "Sioux City Tree Co",
      "status": "active",
      "serviceType": "seo",
      "productMode": "managed",
      "websiteUrl": "https://siouxcitytreeco.com",
      "createdAt": "2025-08-28T08:47:05.816Z"
    },
    {
      "id": "8c1f2a4e-5b7d-4c3e-9a1b-2d3e4f5a6b7c",
      "name": "acme.com",
      "status": "active",
      "serviceType": "seo",
      "productMode": "software",
      "websiteUrl": "https://acme.com",
      "createdAt": "2026-09-14T10:12:44.102Z"
    }
  ],
  "meta": {
    "pagination": {
      "total": 2,
      "limit": 50,
      "offset": 0,
      "has_more": false
    }
  }
}

Response fields

Field	Type	Description
`id`	string	Project UUID, used in every `/projects/{projectId}/...` path
`name`	string	Project name
`status`	string	`trial`, `active` or `past_due`
`serviceType`	string	Always `seo` for API-visible projects
`productMode`	string	`managed` or `software` (see above)
`websiteUrl`	string or null	The tracked website
`createdAt`	string	ISO 8601 creation time

This page is also available as markdown for AI agents, and the whole reference as an OpenAPI spec. Questions? Developer support.