> ## 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 Posts

> Retrieves your most active creators ranked by post count within a specified date range

Retrieves your most active creators ranked by post count 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_posts?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_posts": [
      {
        "id": 100001,
        "name": "Alex Thompson",
        "email": "alex.thompson@example.com",
        "post_count": 31
      },
      {
        "id": 100002,
        "name": "Sarah Miller",
        "email": "sarah.miller@example.com",
        "post_count": 29
      },
      {
        "id": 100003,
        "name": "James Wilson",
        "email": "james.wilson@example.com",
        "post_count": 20
      },
      {
        "id": 100004,
        "name": "Emily Davis",
        "email": "emily.davis@example.com",
        "post_count": 16
      },
      {
        "id": 100005,
        "name": "Michael Chen",
        "email": "michael.chen@example.com",
        "post_count": 14
      },
      {
        "id": 100006,
        "name": "Rachel Park",
        "email": "rachel.park@example.com",
        "post_count": 11
      },
      {
        "id": 100007,
        "name": "David Martinez",
        "email": "david.martinez@example.com",
        "post_count": 10
      },
      {
        "id": 100008,
        "name": "Lisa Wang",
        "email": "lisa.wang@example.com",
        "post_count": 9
      },
      {
        "id": 100009,
        "name": "Thomas Anderson",
        "email": "thomas.anderson@example.com",
        "post_count": 9
      },
      {
        "id": 100010,
        "name": "Sofia Rodriguez",
        "email": "sofia.rodriguez@example.com",
        "post_count": 8
      },
      {
        "id": 100011,
        "name": "Kevin Lee",
        "email": "kevin.lee@example.com",
        "post_count": 7
      },
      {
        "id": 100012,
        "name": "Anna Kim",
        "email": "anna.kim@example.com",
        "post_count": 6
      },
      {
        "id": 100013,
        "name": "John Smith",
        "email": "john.smith@example.com",
        "post_count": 6
      },
      {
        "id": 100014,
        "name": "Maria Garcia",
        "email": "maria.garcia@example.com",
        "post_count": 5
      },
      {
        "id": 100015,
        "name": "Daniel Brown",
        "email": "daniel.brown@example.com",
        "post_count": 5
      },
      {
        "id": 100016,
        "name": "Emma Taylor",
        "email": "emma.taylor@example.com",
        "post_count": 4
      },
      {
        "id": 100017,
        "name": "Oliver White",
        "email": "oliver.white@example.com",
        "post_count": 4
      },
      {
        "id": 100018,
        "name": "Isabella Jones",
        "email": "isabella.jones@example.com",
        "post_count": 4
      },
      {
        "id": 100019,
        "name": "Lucas Green",
        "email": "lucas.green@example.com",
        "post_count": 3
      }
    ]
  },
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "row_count": 163,
    "page_count": 9,
    "has_more": true
  }
}
```


## OpenAPI

````yaml GET /stats/top_creators_by_posts
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_posts:
    get:
      description: >-
        Retrieves your most active creators ranked by post count 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 posts retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    description: Top creators by posts 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

````