Get top creators by engagement

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

GET /stats/top_creators_by_engagement

cURL

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&page=1&per_page=20" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"

200

{
  "success": true,
  "data": {
    "top_creators_by_engagement": [
      {
        "id": 100001,
        "name": "Ella Matthews",
        "email": "[e-mail]",
        "metrics": {
          "views": 1771846,
          "likes": 40279,
          "comments": 840,
          "shares": 16436,
          "total_engagement": 1829401
        }
      },
      {
        "id": 100002,
        "name": "Carlos Bennett",
        "email": "[e-mail]",
        "metrics": {
          "views": 801298,
          "likes": 23163,
          "comments": 514,
          "shares": 1877,
          "total_engagement": 826852
        }
      },
      {
        "id": 100003,
        "name": "Zara Patel",
        "email": "[e-mail]",
        "metrics": {
          "views": 409630,
          "likes": 13975,
          "comments": 76,
          "shares": 0,
          "total_engagement": 423681
        }
      },
      {
        "id": 100004,
        "name": "Leo Fischer",
        "email": "[e-mail]",
        "metrics": {
          "views": 350616,
          "likes": 20011,
          "comments": 206,
          "shares": 5930,
          "total_engagement": 376763
        }
      }
    ]
  },
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "row_count": 127,
    "page_count": 7,
    "has_more": true
  }
}

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

Request parameters

Parameter	Type	Description	Required
start_date	String	Start date in MM/DD/YYYY format	Yes
end_date	String	End date in MM/DD/YYYY format	Yes
limit	Integer	Limit the number of results. Default is 4. Recommended is 20. Set to 10,000 to get all data.	No
page	Integer	Page number for pagination. Default is 1.	No
per_page	Integer	Number of results per page. Default is 40. Maximum is 100.	No

Request example

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&page=1&per_page=20" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"

Response example

{
  "success": true,
  "data": {
    "top_creators_by_engagement": [
      {
        "id": 100001,
        "name": "Ella Matthews",
        "email": "[e-mail]",
        "metrics": {
          "views": 1771846,
          "likes": 40279,
          "comments": 840,
          "shares": 16436,
          "total_engagement": 1829401
        }
      },
      {
        "id": 100002,
        "name": "Carlos Bennett",
        "email": "[e-mail]",
        "metrics": {
          "views": 801298,
          "likes": 23163,
          "comments": 514,
          "shares": 1877,
          "total_engagement": 826852
        }
      },
      {
        "id": 100003,
        "name": "Zara Patel",
        "email": "[e-mail]",
        "metrics": {
          "views": 409630,
          "likes": 13975,
          "comments": 76,
          "shares": 0,
          "total_engagement": 423681
        }
      },
      {
        "id": 100004,
        "name": "Leo Fischer",
        "email": "[e-mail]",
        "metrics": {
          "views": 350616,
          "likes": 20011,
          "comments": 206,
          "shares": 5930,
          "total_engagement": 376763
        }
      }
    ]
  },
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "row_count": 127,
    "page_count": 7,
    "has_more": true
  }
}

cURL

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&page=1&per_page=20" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"

200

{
  "success": true,
  "data": {
    "top_creators_by_engagement": [
      {
        "id": 100001,
        "name": "Ella Matthews",
        "email": "[e-mail]",
        "metrics": {
          "views": 1771846,
          "likes": 40279,
          "comments": 840,
          "shares": 16436,
          "total_engagement": 1829401
        }
      },
      {
        "id": 100002,
        "name": "Carlos Bennett",
        "email": "[e-mail]",
        "metrics": {
          "views": 801298,
          "likes": 23163,
          "comments": 514,
          "shares": 1877,
          "total_engagement": 826852
        }
      },
      {
        "id": 100003,
        "name": "Zara Patel",
        "email": "[e-mail]",
        "metrics": {
          "views": 409630,
          "likes": 13975,
          "comments": 76,
          "shares": 0,
          "total_engagement": 423681
        }
      },
      {
        "id": 100004,
        "name": "Leo Fischer",
        "email": "[e-mail]",
        "metrics": {
          "views": 350616,
          "likes": 20011,
          "comments": 206,
          "shares": 5930,
          "total_engagement": 376763
        }
      }
    ]
  },
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "row_count": 127,
    "page_count": 7,
    "has_more": true
  }
}

Authorizations

Authorization · string · header · required

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

Query Parameters

start_date · string<date> · default: 10/01/2025 · required

Start date in MM/DD/YYYY format

end_date · string<date> · default: 11/14/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

success · boolean

Example:

true

data · object

Top creators by engagement data