TikTok Shop Creators by Product

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

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/product_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/product_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/product_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/product_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/product_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

{
  "data": [
    {
      "id": 123,
      "external_id": "<string>",
      "connected_account": {
        "id": 123,
        "username": "<string>",
        "profile_share_url": "<string>"
      },
      "product_count": 123,
      "latest_date": "<string>",
      "products": [
        {
          "external_product_id": "<string>",
          "product_name": "<string>",
          "product_image_url": "<string>",
          "latest_date": "<string>",
          "total_gmv": 123,
          "total_gmv_formatted": "<string>",
          "total_commission": 123,
          "total_commission_formatted": "<string>",
          "total_refunded_amount": 123,
          "total_refunded_amount_formatted": "<string>",
          "total_estimated_flat_fee": 123,
          "total_estimated_flat_fee_formatted": "<string>",
          "total_units_sold": 123,
          "total_units_sold_formatted": "<string>",
          "total_sku_orders": 123,
          "total_sku_orders_formatted": "<string>",
          "total_items_refunded": 123,
          "total_items_refunded_formatted": "<string>"
        }
      ],
      "affiliate_id": 123,
      "affiliate_name": "<string>",
      "affiliate_email": "<string>",
      "affiliate_avatar_url": "<string>",
      "total_gmv": 123,
      "total_gmv_formatted": "<string>",
      "total_commission": 123,
      "total_commission_formatted": "<string>",
      "total_refunded_amount": 123,
      "total_refunded_amount_formatted": "<string>",
      "total_estimated_flat_fee": 123,
      "total_estimated_flat_fee_formatted": "<string>",
      "total_live_gmv": 123,
      "total_live_gmv_formatted": "<string>",
      "total_product_card_gmv": 123,
      "total_product_card_gmv_formatted": "<string>",
      "total_units_sold": 123,
      "total_units_sold_formatted": "<string>",
      "total_sku_orders": 123,
      "total_sku_orders_formatted": "<string>",
      "total_items_refunded": 123,
      "total_items_refunded_formatted": "<string>"
    }
  ],
  "meta": {
    "row_count": 123,
    "total_pages": 123,
    "current_page": 123,
    "next_page": 123,
    "prev_page": 123,
    "page_size": 123
  },
  "additional_data": {
    "total_gmv": 123,
    "total_units_sold": 123,
    "total_sku_orders": 123,
    "total_commission": 123,
    "total_items_refunded": 123,
    "total_refunded_amount": 123,
    "currency_symbol": "<string>",
    "currency": "<string>"
  }
}

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

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

GET

tik_tok_shop

product_creators

TikTok Shop Creators by Product

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

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/product_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/product_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/product_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/product_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/product_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

{
  "data": [
    {
      "id": 123,
      "external_id": "<string>",
      "connected_account": {
        "id": 123,
        "username": "<string>",
        "profile_share_url": "<string>"
      },
      "product_count": 123,
      "latest_date": "<string>",
      "products": [
        {
          "external_product_id": "<string>",
          "product_name": "<string>",
          "product_image_url": "<string>",
          "latest_date": "<string>",
          "total_gmv": 123,
          "total_gmv_formatted": "<string>",
          "total_commission": 123,
          "total_commission_formatted": "<string>",
          "total_refunded_amount": 123,
          "total_refunded_amount_formatted": "<string>",
          "total_estimated_flat_fee": 123,
          "total_estimated_flat_fee_formatted": "<string>",
          "total_units_sold": 123,
          "total_units_sold_formatted": "<string>",
          "total_sku_orders": 123,
          "total_sku_orders_formatted": "<string>",
          "total_items_refunded": 123,
          "total_items_refunded_formatted": "<string>"
        }
      ],
      "affiliate_id": 123,
      "affiliate_name": "<string>",
      "affiliate_email": "<string>",
      "affiliate_avatar_url": "<string>",
      "total_gmv": 123,
      "total_gmv_formatted": "<string>",
      "total_commission": 123,
      "total_commission_formatted": "<string>",
      "total_refunded_amount": 123,
      "total_refunded_amount_formatted": "<string>",
      "total_estimated_flat_fee": 123,
      "total_estimated_flat_fee_formatted": "<string>",
      "total_live_gmv": 123,
      "total_live_gmv_formatted": "<string>",
      "total_product_card_gmv": 123,
      "total_product_card_gmv_formatted": "<string>",
      "total_units_sold": 123,
      "total_units_sold_formatted": "<string>",
      "total_sku_orders": 123,
      "total_sku_orders_formatted": "<string>",
      "total_items_refunded": 123,
      "total_items_refunded_formatted": "<string>"
    }
  ],
  "meta": {
    "row_count": 123,
    "total_pages": 123,
    "current_page": 123,
    "next_page": 123,
    "prev_page": 123,
    "page_size": 123
  },
  "additional_data": {
    "total_gmv": 123,
    "total_units_sold": 123,
    "total_sku_orders": 123,
    "total_commission": 123,
    "total_items_refunded": 123,
    "total_refunded_amount": 123,
    "currency_symbol": "<string>",
    "currency": "<string>"
  }
}

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

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

Lists creators with a per-product breakdown of their TikTok Shop sales — one row per creator with an embedded products[] array showing how their GMV splits across products for the requested date range. This is the same data as the Products tab (Creators view) of the TikTok Shop store page. For the product-level rollup, see TikTok Shop Products.

Response Fields

Each creator row contains:

Field	Type	Description
`id`	Integer	Internal row id
`external_id`	String	TikTok creator id (oecuid)
`affiliate_id` / `affiliate_name` / `affiliate_email` / `affiliate_avatar_url`	Mixed	Growi creator info (`"N/A"` / null when not on Growi)
`connected_account`	Object	`{ id, username, profile_share_url }`
`product_count`	Integer	Distinct products this creator sold
`latest_date`	String \| null	Most recent date with sales
`total_gmv`	Number	GMV in display currency units
`total_units_sold` / `total_sku_orders` / `total_items_refunded`	Integer	Sales counts
`total_commission` / `total_refunded_amount` / `total_estimated_flat_fee`	Number	Money totals
`products`	Array	Per-product breakdown, GMV descending (fields below)
`*_formatted`	String	Display-string variant of every metric above

Each entry in products[] contains external_product_id, product_name, product_image_url, latest_date, plus the same raw + *_formatted metric pairs (total_gmv, total_units_sold, total_sku_orders, total_commission, total_refunded_amount, total_items_refunded, total_estimated_flat_fee). The response envelope is { data, meta, additional_data }; meta additionally includes page_size.

Request Parameters

Parameter	Type	Description	Required	Default
`start_date`	String	Start of the GMV date range (ISO 8601, `YYYY-MM-DD`)	Yes	—
`end_date`	String	End of the GMV date range (ISO 8601, `YYYY-MM-DD`)	Yes	—
`page`	Integer	Page number	No	1
`per_page`	Integer	Results per page (max 100)	No	20
`search`	String	Free-text search by creator	No	—
`campaign_id`	Integer	Filter to a campaign or contract in your organization	No	—
`creator_id`	Integer	Filter to a single Growi creator (user id)	No	—
`platform`	String	`growi` or `all`	No	`growi`
`product_id`	String	Only include creators who sold this TikTok Shop product	No	—
`all_contracts`	String	`'true'` to include creators from all contracts	No	—
`exclude_contests`	String	`'true'` to exclude TikTok Shop contest campaigns	No	—
`organization_id`	Integer	Narrow to a child organization	No	—

Request Example

curl -X GET "https://api.growi.io/api/public/v1/tik_tok_shop/product_creators?start_date=2026-07-01&end_date=2026-07-31&product_id=1729548090545311965" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"

Response Example

{
  "data": [
    {
      "id": 771122,
      "external_id": "7495033444...",
      "affiliate_id": 98765,
      "affiliate_name": "Jane Creator",
      "connected_account": {
        "id": 4321,
        "username": "janecreates",
        "profile_share_url": "https://www.tiktok.com/@janecreates"
      },
      "product_count": 3,
      "latest_date": "2026-07-29",
      "total_gmv": 20000.0,
      "total_gmv_formatted": "$20,000.00",
      "total_units_sold": 640,
      "total_units_sold_formatted": "640",
      "products": [
        {
          "external_product_id": "1729548090545311965",
          "product_name": "Peach Perfect Multivitamin",
          "product_image_url": "https://...",
          "latest_date": "2026-07-29",
          "total_gmv": 15000.0,
          "total_gmv_formatted": "$15,000.00",
          "total_units_sold": 480,
          "total_units_sold_formatted": "480"
        }
      ]
    }
  ],
  "meta": {
    "row_count": 210,
    "total_pages": 11,
    "current_page": 1,
    "next_page": 2,
    "prev_page": null,
    "page_size": 20
  },
  "additional_data": {
    "total_gmv": 250000.5,
    "total_units_sold": 10400,
    "total_sku_orders": 9020,
    "total_commission": 37500.25,
    "total_items_refunded": 310,
    "total_refunded_amount": 6100.0,
    "currency_symbol": "$",
    "currency": "usd"
  }
}

Use Cases

Answering “who sold this product?” with product_id
Building creator × product performance matrices
Structuring product-seeding decisions around which creators move which SKUs
Reconciling per-product commissions per creator

Notes

Results are always ordered by total GMV descending; there is no sort parameter.
Without a product_id filter, the listing also includes tracked creators with zero sales in the range (matching the dashboard’s row counts); with product_id, only creators who sold that product are returned.
Requests are rate limited (minimum 2 seconds between requests plus an hourly quota); see the X-RateLimit-* response headers.

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>

required

Start of the GMV date range (ISO 8601, YYYY-MM-DD)

end_date

string<date>

required

End of the GMV date range (ISO 8601, YYYY-MM-DD)

page

integer

default:1

Page number (default 1)

per_page

integer

default:20

Results per page: 1-100, default 20

Required range: x <= 100

string

Free-text search

campaign_id

integer

Filter to a campaign or contract belonging to your organization

creator_id

integer

Filter to a single Growi creator (user id)

platform

enum<string>

default:growi

Data scope: growi (only creators on Growi, default), all (all TikTok Shop data), non_growi (creators not on Growi)

Available options:

growi,

all,

non_growi

organization_id

integer

Narrow results to a child organization (id) of the API key organization

all_contracts

enum<string>

Set to 'true' to include creators from all contracts

Available options:

true

exclude_contests

enum<string>

Set to 'true' to exclude TikTok Shop contest campaigns

Available options:

true

product_id

string

Only include creators who sold this TikTok Shop product id

Response

Product creators listed

data

object[]

required

Show child attributes

Get Started

Essentials

API Documentation

Tracking Events

Stats API

TikTok Shop API

Organization API

Conversions API

TikTok Shop Creators by Product

Response Fields

Request Parameters

Request Example

Response Example

Use Cases

Notes

Authorizations

Query Parameters

Response

​Response Fields

​Request Parameters

​Request Example

​Response Example

​Use Cases

​Notes

Authorizations

Query Parameters

Response

Response Fields

Request Parameters

Request Example

Response Example

Use Cases

Notes