List creators

GET/v1/discover/creators

Authorization

bearerAuth

AuthorizationBearer <token>

API token issued from the dashboard (Settings → API Tokens). Sent as Authorization: Bearer <token>.

In: header

Query Parameters

search?string

role?string

Filter by role: creator, competitor, self, company, a comma list, or !company to exclude.

status?string

Value in"active" | "paused" | "archived"

isFavorite?boolean

platform?string

Only creators that have a handle on this platform.

limit?integer

Default100

Range1 <= value <= 500

offset?integer

Default0

Range0 <= value <= 9007199254740991

Response Body

`application/json`

cURL

curl -X GET "https://example.com/discover/creators"

{
  "success": true,
  "creators": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "description": "string",
      "role": "string",
      "status": "string",
      "website": "string",
      "handles": {
        "property1": "string",
        "property2": "string"
      },
      "tags": [
        "string"
      ],
      "isFavorite": true,
      "lastScrapedAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "limit": -9007199254740991,
    "offset": -9007199254740991,
    "hasMore": true,
    "total": -9007199254740991
  }
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

{
  "error": "unauthorized"
}

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`