Skip to main content
GET
/
api
/
creators
Creators
curl --request GET \
  --url https://api.example.com/api/creators

​
Authentication

Optional. If authenticated, includes isFollowing status.

​
Query Parameters

ParameterTypeDefaultDescription
pageinteger1Page number
limitinteger12Items per page
sortstringrecentSort order: recent, trending, or popular

​
Sort Options

SortDescription
recentNewest accounts first
popularMost total likes (recipes + posts + collections)
trendingMost engagement in the last 12 hours
The trending algorithm counts favorites received across all content types within a 12-hour window, with total likes as a tiebreaker.

​
Response

{
  "creators": [
    {
      "id": "uuid",
      "username": "filmshooter",
      "firstName": "John",
      "surname": "Doe",
      "avatarUrl": "https://...",
      "followerCount": 150,
      "totalLikes": 420,
      "createdAt": "2025-01-01T00:00:00Z",
      "isFollowing": false
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 12,
    "total": 6,
    "totalPages": 1
  }
}

​
Error Responses

StatusCodeDescription
400VALIDATION_ERRORInvalid sort or pagination params