SKU performance

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/analytics/skus/{skuId}/performance \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/analytics/skus/{skuId}/performance"

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/analytics/skus/{skuId}/performance', 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/analytics/skus/{skuId}/performance",
  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/analytics/skus/{skuId}/performance"

	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/analytics/skus/{skuId}/performance")

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

{
  "skuId": "1729000000000000101",
  "productId": "1729000000000000100",
  "intervals": [
    {
      "startDate": "2026-09-01",
      "endDate": "2026-09-02",
      "gmv": {
        "amount": "149.94",
        "currency": "USD"
      },
      "gmvByChannel": [
        {
          "type": "VIDEO",
          "amount": "99.96",
          "currency": "USD"
        },
        {
          "type": "PRODUCT_CARD",
          "amount": "49.98",
          "currency": "USD"
        }
      ],
      "itemsSold": 6,
      "itemsSoldByChannel": [
        {
          "type": "VIDEO",
          "count": 4
        },
        {
          "type": "PRODUCT_CARD",
          "count": 2
        }
      ],
      "skuOrders": 6
    }
  ],
  "latestAvailableDate": "2026-09-27"
}

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

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

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

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

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

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

SKU performance

Returns one SKU’s GMV, items sold and SKU orders per day or as one total, from TikTok’s analytics. Each interval is split by channel (LIVE, VIDEO, PRODUCT_CARD) in gmvByChannel and itemsSoldByChannel.

start_date is inclusive and end_date is exclusive (YYYY-MM-DD, shop timezone), so pass the day after the last day you want. Interval endDate values are exclusive too. TikTok rejects windows starting more than about 180 days back. granularity is 1D (default) or ALL. currency is USD or LOCAL (TikTok’s default). latestAvailableDate shows the newest day TikTok has data for.

GET

tik_tok_shop

analytics

skus

{skuId}

performance

SKU performance

curl --request GET \
  --url https://api.growi.io/api/public/v1/tik_tok_shop/analytics/skus/{skuId}/performance \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.growi.io/api/public/v1/tik_tok_shop/analytics/skus/{skuId}/performance"

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/analytics/skus/{skuId}/performance', 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/analytics/skus/{skuId}/performance",
  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/analytics/skus/{skuId}/performance"

	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/analytics/skus/{skuId}/performance")

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

{
  "skuId": "1729000000000000101",
  "productId": "1729000000000000100",
  "intervals": [
    {
      "startDate": "2026-09-01",
      "endDate": "2026-09-02",
      "gmv": {
        "amount": "149.94",
        "currency": "USD"
      },
      "gmvByChannel": [
        {
          "type": "VIDEO",
          "amount": "99.96",
          "currency": "USD"
        },
        {
          "type": "PRODUCT_CARD",
          "amount": "49.98",
          "currency": "USD"
        }
      ],
      "itemsSold": 6,
      "itemsSoldByChannel": [
        {
          "type": "VIDEO",
          "count": 4
        },
        {
          "type": "PRODUCT_CARD",
          "count": 2
        }
      ],
      "skuOrders": 6
    }
  ],
  "latestAvailableDate": "2026-09-27"
}

{
  "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.

Path Parameters

skuId

string

required

TikTok SKU id.

Pattern: ^[0-9]{1,32}$

Query Parameters

start_date

string<date>

required

Window start, YYYY-MM-DD inclusive (shop timezone).

end_date

string<date>

required

Window end, YYYY-MM-DD EXCLUSIVE (TikTok's end_date_lt semantics). TikTok rejects windows starting more than ~180 days back.

granularity

enum<string>

default:1D

1D = one interval per day, ALL = one aggregate interval.

Available options:

1D,

ALL

currency

enum<string>

TikTok defaults to LOCAL.

Available options:

USD,

LOCAL

organization_id

integer

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

Response

The SKU's intervals.

skuId

string | null

productId

string | null

latestAvailableDate

string | null

intervals

object[]

Show child attributes

Overview

Conversions

Tracking events

Campaign affiliates

Organization

Applications

Stats

TikTok Shop

SKU performance

Authorizations

Path Parameters

Query Parameters

Response