Top TikTok Shop Products by GMV

cURL

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

import requests

url = "https://api.growi.io/api/public/v1/stats/tik_tok_shop_products"

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/stats/tik_tok_shop_products', 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/stats/tik_tok_shop_products",
  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/stats/tik_tok_shop_products"

	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/stats/tik_tok_shop_products")

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

{
  "success": true,
  "data": {
    "tik_tok_shop_products": {
      "products": [
        {
          "product_id": "1729548090545311965",
          "product_name": "Peach Perfect Inositol Multivitamin - Peach Perfect Myo-Inositol, D-Chiro Inositol, Omega 3 Fitness Healthcare",
          "total_gmv": 127054.59,
          "total_orders": 4086,
          "unique_videos": 456
        }
      ]
    }
  }
}

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

GET

stats

tik_tok_shop_products

cURL

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

import requests

url = "https://api.growi.io/api/public/v1/stats/tik_tok_shop_products"

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/stats/tik_tok_shop_products', 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/stats/tik_tok_shop_products",
  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/stats/tik_tok_shop_products"

	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/stats/tik_tok_shop_products")

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

{
  "success": true,
  "data": {
    "tik_tok_shop_products": {
      "products": [
        {
          "product_id": "1729548090545311965",
          "product_name": "Peach Perfect Inositol Multivitamin - Peach Perfect Myo-Inositol, D-Chiro Inositol, Omega 3 Fitness Healthcare",
          "total_gmv": 127054.59,
          "total_orders": 4086,
          "unique_videos": 456
        }
      ]
    }
  }
}

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

Retrieves TikTok Shop product-level Gross Merchandise Value (GMV) data. Returns aggregated statistics for each product including total GMV, order counts, and the number of unique videos that promoted each product within the specified date range.

Response Fields

Each product object contains the following fields:

Field	Type	Description
`product_id`	String	Unique identifier for the TikTok Shop product
`product_name`	String	Full name/title of the product
`total_gmv`	Float	Total Gross Merchandise Value (revenue) generated by this product
`total_orders`	Integer	Total number of orders for this product
`unique_videos`	Integer	Number of unique videos that promoted this product

Request Parameters

Parameter	Type	Description	Required	Default
`start_date`	String	Start date in MM/DD/YYYY format	Yes	Current date - 30 days
`end_date`	String	End date in MM/DD/YYYY format	Yes	Current date

Request Example

curl -X GET "https://api.growi.io/api/public/v1/stats/tik_tok_shop_products?start_date=10/04/2025&end_date=11/03/2025" \
     -H "Authorization: Bearer YOUR_PUBLIC_API_KEY" \
     -H "Content-Type: application/json"

Response Example

{
  "success": true,
  "data": {
    "tik_tok_shop_products": {
      "products": [
        {
          "product_id": "1729548090545311965",
          "product_name": "Peach Perfect Inositol Multivitamin - Peach Perfect Myo-Inositol, D-Chiro Inositol, Omega 3 Fitness Healthcare",
          "total_gmv": 127054.59,
          "total_orders": 4086,
          "unique_videos": 456
        },
        {
          "product_id": "1729652672780669149",
          "product_name": "Peach Perfect Creatine Monohydrate Powder, Creatine for Women with Collagen, BCAAs, 5g Vegan Micronized Creatine per Serving",
          "total_gmv": 11337.36,
          "total_orders": 319,
          "unique_videos": 102
        },
        {
          "product_id": "1730909105194569949",
          "product_name": "Peach Perfect Menopause Multivitamin - Capsules - 30 Servings - Black Cohosh, Ashwagandha, Vitamin C, D3+K2",
          "total_gmv": 6838.63,
          "total_orders": 199,
          "unique_videos": 58
        }
        // Additional products...
      ]
    }
  }
}

Use Cases

This endpoint is useful for:

Identifying top-performing products by GMV
Analyzing which products generate the most orders
Understanding product reach through unique video counts
Optimizing inventory and marketing strategies based on product performance
Building product performance dashboards
Tracking product-level attribution across influencer campaigns
Comparing product performance across different time periods

Notes

Products are returned sorted by total_gmv in descending order (highest GMV first)
The unique_videos count represents distinct videos that featured or promoted the product
GMV values represent actual revenue generated, not including refunds or cancellations

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/04/2025

required

Start date in MM/DD/YYYY format

end_date

string<date>

default:11/03/2025

required

End date in MM/DD/YYYY format

Response

TikTok Shop Products data retrieved successfully

success

boolean

Example:

true

data

object

Show child attributes

Get Started

Essentials

API Documentation

Tracking Events

Stats API

TikTok Shop API

Organization API

Conversions API

Top TikTok Shop Products by GMV

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