Skip to main content
GET
/
creators
List creators
curl --request GET \
  --url https://api.creatoraudit.com/v2/creators \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "type": "creator",
      "is_active": false,
      "metadata": {},
      "accounts_summary": {
        "total": 0,
        "platforms": {},
        "total_followers": 0
      }
    }
  ],
  "pagination": {
    "has_next": true,
    "limit": 123,
    "next_cursor": "<string>",
    "total_count": 123
  },
  "filters": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:50

Page size (1–200).

Required range: 1 <= x <= 200
cursor
string | null

Opaque pagination.next_cursor from the previous page.

sort
string
default:name

Legacy signed sort string (e.g. name or -name). Prefer order_by + order_direction. Only name is supported.

order_by
string | null

Field to sort by. Overrides sort.

Allowed value: "name"
order_direction
enum<string> | null

Sort direction (default asc for name). Used with order_by.

Available options:
asc,
desc
is_active
boolean | null

Filter by active vs archived creators.

include_total
boolean
default:false

When true, the response includes pagination.total_count. Adds one extra COUNT(*) query — leave off for cheap paging.

Response

Successful Response

data
CreatorResponse · object[]
required
pagination
object
required
filters
Filters · object