Top affiliate creators

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "creators": [
    {
      "creatorKey": "creator_one",
      "creatorUsername": "creator_one",
      "gmvGross": 3120.4,
      "orders": 88,
      "skuOrders": 91,
      "itemsSold": 97,
      "commissionEstimated": 468.06,
      "lastOrderAt": "2026-09-07T21:14:03.000Z"
    },
    {
      "creatorKey": "creator_two",
      "creatorUsername": "creator_two",
      "gmvGross": 1875,
      "orders": 50,
      "skuOrders": 50,
      "itemsSold": 53,
      "commissionEstimated": 281.25,
      "lastOrderAt": "2026-09-06T17:40:51.000Z"
    }
  ],
  "nextCursor": "WyJleGFtcGxlIiwiY3Vyc29yIl0",
  "window": {
    "startDate": "2026-09-01",
    "endDate": "2026-09-07"
  },
  "scope": "all",
  "sweptThrough": "2026-09-28T06:00:00.000Z"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Top affiliate creators

Lists the shop’s affiliate creators ranked by GMV over a date window. Each row has creatorKey (the creator’s open id, else username, stable across renames), creatorUsername, gmvGross, orders, skuOrders, itemsSold, commissionEstimated and lastOrderAt.

start_date and end_date are YYYY-MM-DD UTC days, both inclusive. scope is all (default) or growi (only collabs created through Growi). limit is 1 to 500 (default 50). When more creators exist the response has nextCursor; pass it back as cursor with the same dates and scope, and stop when it’s absent. A cursor sent with a different window or scope is rejected. In a window that includes today, GMV still moves as orders sync, so a creator can shift between pages. Page through a closed window for exports. sweptThrough shows how fresh the data is.

GET

tik_tok_shop

affiliate

creators

Top affiliate creators

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.growi.io/api/public/v1/tik_tok_shop/affiliate/creators")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "creators": [
    {
      "creatorKey": "creator_one",
      "creatorUsername": "creator_one",
      "gmvGross": 3120.4,
      "orders": 88,
      "skuOrders": 91,
      "itemsSold": 97,
      "commissionEstimated": 468.06,
      "lastOrderAt": "2026-09-07T21:14:03.000Z"
    },
    {
      "creatorKey": "creator_two",
      "creatorUsername": "creator_two",
      "gmvGross": 1875,
      "orders": 50,
      "skuOrders": 50,
      "itemsSold": 53,
      "commissionEstimated": 281.25,
      "lastOrderAt": "2026-09-06T17:40:51.000Z"
    }
  ],
  "nextCursor": "WyJleGFtcGxlIiwiY3Vyc29yIl0",
  "window": {
    "startDate": "2026-09-01",
    "endDate": "2026-09-07"
  },
  "scope": "all",
  "sweptThrough": "2026-09-28T06:00:00.000Z"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

{
  "error": "<string>",
  "code": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

start_date

string

required

Window start, YYYY-MM-DD INCLUSIVE (local-aggregates convention).

end_date

string

required

Window end, YYYY-MM-DD, inclusive.

scope

enum<string>

default:all

all = every affiliate order in the window; growi = only orders on target collabs created through Growi.

Available options:

all,

growi

limit

integer

default:50

Max creators returned (default 50, max 500).

Required range: 1 <= x <= 500

cursor

string

Opaque; from the previous response's nextCursor. Only valid with the start_date, end_date and scope it came from.

organization_id

integer

Use the TikTok Shop of this child brand (organization id) of your API key's organization

Response

{ creators: [...] } (each row also carries creatorKey: the row's group key, the creator's open id, else the username; stable across renames) plus window {startDate, endDate}, scope, and sweptThrough (ISO timestamp orders are swept through, null when this shop has never swept). nextCursor is present only when more creators exist; a caller that sends no cursor gets the same first page as before paging existed.

Overview

Conversions

Tracking events

Campaign affiliates

Organization

Applications

Stats

TikTok Shop

Top affiliate creators

Authorizations

Query Parameters

Response