Stats (older)

Creators ranked by attributed sales

GET/api/public/v1/stats/top_creators_by_gmv
LiveAnswers from your brand's records now.

Deprecated. It keeps working; new code should use /stores/overview/shopify/stats. See deprecations.

Operation id getTopCreatorsByGmv

Request

curl

curl "https://creator.growthdept.ai/api/public/v1/stats/top_creators_by_gmv?start_date=2026-11-01&end_date=2026-11-01" \
  -H "Authorization: Bearer gdc_..."

Parameters

NameInTypeNotes
start_datequerystring (date)required Default 10/01/2025
end_datequerystring (date)required Default 11/14/2025
limitqueryinteger Default 4
include_discordqueryboolean Default false
organization_idqueryinteger
campaign_idqueryinteger

Responses

200Success

FieldTypeNotes
dataobject
data.metaobject
data.meta.current_pageinteger
data.meta.has_moreboolean
data.meta.page_countinteger
data.meta.per_pageinteger
data.meta.row_countinteger
data.top_creators_by_gmvarray of object
data.top_creators_by_gmv[].[].brand_namestring
data.top_creators_by_gmv[].[].discord_idstring
data.top_creators_by_gmv[].[].discord_usernamestring
data.top_creators_by_gmv[].[].emailstring
data.top_creators_by_gmv[].[].idinteger
data.top_creators_by_gmv[].[].namestring
data.top_creators_by_gmv[].[].social_accountsarray of object
data.top_creators_by_gmv[].[].social_accounts[].[].connected_account_usernamestring
data.top_creators_by_gmv[].[].social_accounts[].[].platform_namestring
data.top_creators_by_gmv[].[].social_accounts[].[].profile_share_urlstring
data.top_creators_by_gmv[].[].social_accounts[].[].total_gmvnumber
data.top_creators_by_gmv[].[].total_gmvnumber
successboolean

Example

{
  "data": {
    "meta": {
      "current_page": 1,
      "has_more": true,
      "page_count": 1,
      "per_page": 1,
      "row_count": 3
    },
    "top_creators_by_gmv": [
      {
        "brand_name": "Example name",
        "discord_id": "string",
        "discord_username": "Example name",
        "email": "creator@example.com",
        "id": 1024,
        "name": "Example name",
        "social_accounts": [
          {
            "connected_account_username": null,
            "platform_name": null,
            "profile_share_url": null,
            "total_gmv": null
          }
        ],
        "total_gmv": 125.5
      }
    ]
  },
  "success": true
}

Errors: 401with an error and usually a message. See errors.

Example values are made up from each field's type and name.