GET
/
stats
/
top_creators_by_gmv
cURL
curl --request GET \
  --url https://api.growi.io/api/public/v1/stats/top_creators_by_gmv \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {}
}
Retrieves your top-performing creators ranked by Gross Merchandise Value (GMV) 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
include_discordBooleanInclude Discord account ID and username for creators. Default is false.No

Request Example

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

Response Example

{
  "success": true,
  "data": {
    "top_creators_by_gmv": [
      {
        "id": 100001,
        "name": "Alex Thompson",
        "email": "alex.thompson@example.com",
        "total_gmv": 187542.75,
        "discord_id": "123456789012345678",
        "discord_username": "alexthompson#1234"
      },
      {
        "id": 100002,
        "name": "Sarah Miller",
        "email": "sarah.miller@example.com",
        "total_gmv": 156874.32,
        "discord_id": "234567890123456789",
        "discord_username": "sarahmiller#5678"
      },
      {
        "id": 100003,
        "name": "James Wilson",
        "email": "james.wilson@example.com",
        "total_gmv": 132547.84,
        "discord_id": "345678901234567890",
        "discord_username": "jameswilson#9012"
      },
      {
        "id": 100004,
        "name": "Emily Davis",
        "email": "emily.davis@example.com",
        "total_gmv": 98754.67,
        "discord_id": "456789012345678901",
        "discord_username": "emilydavis#3456"
      },
      {
        "id": 100005,
        "name": "Michael Chen",
        "email": "michael.chen@example.com",
        "total_gmv": 87542.28,
        "discord_id": "567890123456789012",
        "discord_username": "michaelchen#7890"
      }
    ]
  }
} 

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:05/01/2025
required

Start date in MM/DD/YYYY format

end_date
string<date>
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.

include_discord
boolean
default:false

Include Discord account ID and username for creators. Default is false.

Response

Top creators by GMV retrieved successfully

success
boolean
Example:

true

data
object

Top creators by GMV data