Skip to main content
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": {
    "top_creators_by_gmv": [
      {
        "brand_name": "Example Brand",
        "id": 12,
        "name": "John Doe",
        "email": "john.doe@example.com",
        "total_gmv": 1284.53,
        "social_accounts": [
          {
            "connected_account_username": "johndoe_official",
            "platform_name": "tik_tok",
            "profile_share_url": "https://www.tiktok.com/@johndoe_official",
            "total_gmv": 1284.53
          }
        ],
        "discord_id": "779513406264180746",
        "discord_username": "johndoe"
      }
    ],
    "meta": {
      "current_page": 4,
      "per_page": 4,
      "row_count": 448,
      "page_count": 112,
      "has_more": true
    }
  }
}
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. Maximum is 20.No
include_discordBooleanInclude Discord account ID and username for creators. Default is false.No
organization_idIntegerFilter results by specific organization IDNo
campaign_idIntegerFilter results by specific campaign IDNo

​
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&organization_id=123&campaign_id=16503" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"

​
Response Example

{
  "success": true,
  "data": {
    "top_creators_by_gmv": [
      {
        "brand_name": "Example Brand",
        "id": 1689332,
        "name": "John Doe",
        "email": "john.doe@example.com",
        "total_gmv": 1284.53,
        "discord_id": "779513406264180746",
        "discord_username": "johndoe",
        "social_accounts": [
          {
            "connected_account_username": "johndoe_official",
            "platform_name": "tik_tok",
            "profile_share_url": "https://www.tiktok.com/@johndoe_official",
            "total_gmv": 1284.53
          }
        ],
        "campaigns": [
          {
            "campaign_id": 16503,
            "campaign_name": "Example Campaign",
            "total_gmv": 1284.53
          }
        ],
        "brands": ["Brand A", "Brand B"]
      },
      {
        "brand_name": "Example Brand",
        "id": 1518565,
        "name": "Jane Smith",
        "email": "jane.smith@example.com",
        "total_gmv": 1030.98,
        "discord_id": "1298726946167062610",
        "discord_username": "janesmith",
        "social_accounts": [
          {
            "connected_account_username": "janesmith_creator",
            "platform_name": "tik_tok",
            "profile_share_url": "https://www.tiktok.com/@janesmith_creator",
            "total_gmv": 1030.98
          },
          {
            "connected_account_username": "janesmith_official",
            "platform_name": "tik_tok",
            "profile_share_url": "https://www.tiktok.com/@janesmith_official",
            "total_gmv": 0.0
          }
        ],
        "campaigns": [
          {
            "campaign_id": 16425,
            "campaign_name": "Example Campaign 2",
            "total_gmv": 1030.98
          }
        ],
        "brands": ["Brand C"]
      },
      {
        "brand_name": "Example Brand",
        "id": 1518526,
        "name": "Alex Johnson",
        "email": "alex.johnson@example.com",
        "total_gmv": 914.76,
        "discord_id": "1298730253337886761",
        "discord_username": "alexjohnson",
        "social_accounts": [
          {
            "connected_account_username": "alexjohnson_official",
            "platform_name": "tik_tok",
            "profile_share_url": "https://www.tiktok.com/@alexjohnson_official",
            "total_gmv": 810.46
          },
          {
            "connected_account_username": "alexjohnson_alt",
            "platform_name": "tik_tok",
            "profile_share_url": "https://www.tiktok.com/@alexjohnson_alt",
            "total_gmv": 104.3
          }
        ],
        "campaigns": [
          {
            "campaign_id": 16421,
            "campaign_name": "Example Campaign 3",
            "total_gmv": 914.76
          }
        ],
        "brands": ["Brand D", "Brand E"]
      },
      {
        "brand_name": "Example Brand",
        "id": 1513063,
        "name": "Sarah Wilson",
        "email": "sarah.wilson@example.com",
        "total_gmv": 900.66,
        "discord_id": "1002332508874096720",
        "discord_username": "sarahwilson",
        "social_accounts": [
          {
            "connected_account_username": "sarahwilson_main",
            "platform_name": "tik_tok",
            "profile_share_url": "https://www.tiktok.com/@sarahwilson_main",
            "total_gmv": 791.66
          },
          {
            "connected_account_username": "sarahwilson_brand",
            "platform_name": "tik_tok",
            "profile_share_url": "https://www.tiktok.com/@sarahwilson_brand",
            "total_gmv": 109.0
          }
        ],
        "campaigns": [
          {
            "campaign_id": 16424,
            "campaign_name": "Example Campaign 4",
            "total_gmv": 900.66
          }
        ],
        "brands": ["Brand F"]
      }
    ]
  },
  "meta": {
    "current_page": 4,
    "per_page": 4,
    "row_count": 448,
    "page_count": 112,
    "has_more": true
  }
}

​
Response Fields

FieldTypeDescription
successBooleanIndicates whether the request was successful
dataObjectContainer for the response data
data.top_creators_by_gmvArrayArray of creator objects ranked by GMV
data.top_creators_by_gmv[].brand_nameStringName of the brand the creator is associated with
data.top_creators_by_gmv[].idIntegerUnique identifier for the creator
data.top_creators_by_gmv[].nameStringDisplay name of the creator
data.top_creators_by_gmv[].emailStringEmail address of the creator
data.top_creators_by_gmv[].total_gmvNumberTotal GMV generated by the creator
data.top_creators_by_gmv[].social_accountsArrayArray of connected social media accounts
data.top_creators_by_gmv[].social_accounts[].connected_account_usernameStringUsername on the social media platform
data.top_creators_by_gmv[].social_accounts[].platform_nameStringName of the social media platform
data.top_creators_by_gmv[].social_accounts[].profile_share_urlStringDirect URL to the creator’s profile
data.top_creators_by_gmv[].social_accounts[].total_gmvNumberGMV generated through this specific social account
data.top_creators_by_gmv[].campaignsArrayArray of campaigns the creator is associated with
data.top_creators_by_gmv[].campaigns[].campaign_idIntegerUnique identifier for the campaign
data.top_creators_by_gmv[].campaigns[].campaign_nameStringName of the campaign
data.top_creators_by_gmv[].campaigns[].total_gmvNumberTotal GMV generated by the creator for this campaign
data.top_creators_by_gmv[].brandsArrayArray of brand names the creator is associated with
data.top_creators_by_gmv[].discord_idStringDiscord user ID (included when include_discord=true)
data.top_creators_by_gmv[].discord_usernameStringDiscord username (included when include_discord=true)
metaObjectPagination metadata
meta.current_pageIntegerCurrent page number
meta.per_pageIntegerNumber of results per page
meta.row_countIntegerTotal number of rows/records
meta.page_countIntegerTotal number of pages
meta.has_moreBooleanWhether there are more pages available

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. Maximum is 20.

​
include_discord
boolean
default:false

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

​
organization_id
integer

Filter results by specific organization ID

​
campaign_id
integer

Filter results by specific campaign ID

Response

Top creators by GMV retrieved successfully

​
success
boolean
Example:

true

​
data
object