> ## Documentation Index
> Fetch the complete documentation index at: https://growi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Top Creators By Engagement

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

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

```bash theme={null}
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

```json theme={null}
{
  "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
        }
      }
    ]
  },
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "row_count": 127,
    "page_count": 7,
    "has_more": true
  }
}
```


## OpenAPI

````yaml GET /stats/top_creators_by_engagement
openapi: 3.0.1
info:
  title: Growi API
  description: >-
    API documentation for Growi platform, showcasing the public tracking event
    endpoint
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.growi.io/api/public/v1
security:
  - bearerAuth: []
paths:
  /stats/top_creators_by_engagement:
    get:
      description: >-
        Retrieves your top-performing creators ranked by total engagement within
        a specified date range
      parameters:
        - name: start_date
          in: query
          required: true
          example: 10/01/2025
          schema:
            type: string
            format: date
            default: 10/01/2025
          description: Start date in MM/DD/YYYY format
        - name: end_date
          in: query
          required: true
          example: 11/14/2025
          schema:
            type: string
            format: date
            default: 11/14/2025
          description: End date in MM/DD/YYYY format
        - name: limit
          in: query
          required: false
          example: 4
          schema:
            type: integer
            default: 4
          description: >-
            Limit the number of results. Default is 4. Recommended is 20. Set to
            10,000 to get all data.
      responses:
        '200':
          description: Top creators by engagement retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    description: Top creators by engagement data
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````