List Projects

List all SEO projects for the authenticated user

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

Returns every active SEO project the API key holder can access: the projects they own, plus projects shared through their team (the account that invited them, their team members and sibling team members) and any project shared with them individually - the same set as their Projects page. Only projects with trial, active, or past_due status are included.

Each project carries access (owner when the key holder owns it, team when it comes through the team) and the ownerUserId of the account that owns it, so agencies can tell whose project is whose.

Every project also carries productMode. It is managed for every project you can create today (Ranked AI's team does the work and the full software suite is included in the plan); software appears only on legacy self-serve projects from accounts that had the software tier before it closed to new accounts.

Query parameters

limitnumberdefault: 50

Maximum number of projects to return (max: 500)

offsetnumberdefault: 0

Number of projects to skip for pagination

Request

curl "https://app.ranked.ai/api/v1/projects" \
  -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",
      "ownerUserId": "2f5e9c7a-1b3d-4e6f-8a9b-0c1d2e3f4a5b",
      "access": "owner"
    },
    {
      "id": "8c1f2a4e-5b7d-4c3e-9a1b-2d3e4f5a6b7c",
      "name": "acme.com",
      "status": "active",
      "serviceType": "seo",
      "productMode": "managed",
      "websiteUrl": "https://acme.com",
      "createdAt": "2026-09-14T10:12:44.102Z",
      "ownerUserId": "7a1c3e5f-9b2d-4f6a-8c0e-1d3f5a7b9c2e",
      "access": "team"
    }
  ],
  "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` (legacy self-serve projects report `software`, see above)
`websiteUrl`	string or null	The tracked website
`createdAt`	string	ISO 8601 creation time
`ownerUserId`	string	The account that owns the project
`access`	string	`owner` (you own it) or `team` (shared through your team or an individual grant)

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