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

Retrieves your most active creators ranked by post count 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

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" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"

​
Response Example

{
  "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
      }
    ]
  }
}

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 posts retrieved successfully

The response is of type object.