GET
/
stats
/
top_creators_by_engagement
curl --request GET \
  --url https://api.growi.io/api/public/v1/stats/top_creators_by_engagement \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {}
}

Retrieves your top-performing creators ranked by total engagement within a specified date range.

​
Request Parameters

ParameterTypeDescriptionRequired
start_dateStringStart date in MM/DD/YYYY formatYes
end_dateStringEnd date in MM/DD/YYYY formatYes
limitIntegerLimit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data.No

​
Request Example```bash

curl -X GET “https://api.growi.io/api/public/v1/stats/top_creators_by_engagement?start_date=01/01/2023&end_date=01/31/2023&limit=5”
-H “Authorization: Bearer YOUR_PUBLIC_API_KEY”
-H “Content-Type: application/json”

## Response Example

```json
{
  "success": true,
  "data": {
    "top_creators_by_engagement": [
      {
        "id": 100001,
        "name": "Ella Matthews",
        "email": "ella.matthews@example.com",
        "metrics": {
          "views": 1771846,
          "likes": 40279,
          "comments": 840,
          "shares": 16436,
          "total_engagement": 1829401
        }
      },
      {
        "id": 100002,
        "name": "Carlos Bennett",
        "email": "carlos.bennett@example.com",
        "metrics": {
          "views": 801298,
          "likes": 23163,
          "comments": 514,
          "shares": 1877,
          "total_engagement": 826852
        }
      },
      {
        "id": 100003,
        "name": "Zara Patel",
        "email": "zara.patel@example.com",
        "metrics": {
          "views": 409630,
          "likes": 13975,
          "comments": 76,
          "shares": 0,
          "total_engagement": 423681
        }
      },
      {
        "id": 100004,
        "name": "Leo Fischer",
        "email": "leo.fischer@example.com",
        "metrics": {
          "views": 350616,
          "likes": 20011,
          "comments": 206,
          "shares": 5930,
          "total_engagement": 376763
        }
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
start_date
string
default:05/01/2025
required

Start date in MM/DD/YYYY format

​
end_date
string
default:05/08/2025
required

End date in MM/DD/YYYY format

​
limit
integer
default:4

Limit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data.

Response

200
application/json

Top creators by engagement retrieved successfully

The response is of type object.