Get TikTok Shop GMV 24h

Retrieves TikTok Shop Gross Merchandise Value (GMV) data with daily breakdown and comparison to previous period

GET /stats/tik_tok_shop_gmv_24h

cURL

cURL

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

import requests

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

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_gmv_24h', 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_gmv_24h",
  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_gmv_24h"

	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))

}

HttpResponse<String> response = Unirest.get("https://api.growi.io/api/public/v1/stats/tik_tok_shop_gmv_24h")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.growi.io/api/public/v1/stats/tik_tok_shop_gmv_24h")

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

200

{
  "success": true,
  "data": {
    "tik_tok_shop_gmv_24h": [
      {
        "date": "2025-10-04",
        "last_date": 1756872000,
        "current": "$1,985.10",
        "last": "$2,684.88",
        "total": "$55,991.01",
        "last_total": "$78,445.73",
        "order_count": 68,
        "last_order_count": 99,
        "total_order_count": 1759,
        "last_total_order_count": 2489
      }
    ]
  }
}

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

Retrieves TikTok Shop Gross Merchandise Value (GMV) data with daily breakdown and comparison to previous period. Returns time-series data showing GMV performance, order counts, and period-over-period comparisons for each day in the specified date range.

Request Parameters

Parameter	Type	Description	Required
start_date	String	Start date in MM/DD/YYYY format	Yes
end_date	String	End date in MM/DD/YYYY format	Yes

Request Example

curl -X GET "https://api.growi.io/api/public/v1/stats/tik_tok_shop_gmv_24h?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_gmv_24h": [
      {
        "date": "2025-10-04",
        "last_date": 1756872000,
        "current": "$1,985.10",
        "last": "$2,684.88",
        "last_total": "$78,445.73",
        "total": "$55,991.01",
        "order_count": 68,
        "last_order_count": 99,
        "total_order_count": 1759,
        "last_total_order_count": 2489
      },
      {
        "date": "2025-10-05",
        "last_date": 1756958400,
        "current": "$1,885.52",
        "last": "$2,628.08",
        "last_total": "$78,445.73",
        "total": "$55,991.01",
        "order_count": 57,
        "last_order_count": 92,
        "total_order_count": 1759,
        "last_total_order_count": 2489
      },
      {
        "date": "2025-10-06",
        "last_date": 1757044800,
        "current": "$1,832.69",
        "last": "$4,073.24",
        "last_total": "$78,445.73",
        "total": "$55,991.01",
        "order_count": 57,
        "last_order_count": 138,
        "total_order_count": 1759,
        "last_total_order_count": 2489
      }
    ]
  }
}

Response Fields

Field	Type	Description
date	String	The date for this data point (YYYY-MM-DD format)
last_date	Integer	Unix timestamp for the corresponding date in the previous period
current	String	GMV for the current date (formatted as currency string)
last	String	GMV for the corresponding date in the previous period (formatted as currency string)
total	String	Cumulative GMV total for the current period (formatted as currency string)
last_total	String	Cumulative GMV total for the previous period (formatted as currency string)
order_count	Integer	Number of orders on the current date
last_order_count	Integer	Number of orders on the corresponding date in the previous period
total_order_count	Integer	Cumulative order count for the current period
last_total_order_count	Integer	Cumulative order count for the previous period

Use Cases

This endpoint is useful for:

• Tracking daily TikTok Shop GMV performance over time
• Comparing current period performance to previous period
• Building custom GMV dashboards and analytics
• Monitoring order volume trends
• Calculating period-over-period growth rates

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

200

application/json

TikTok Shop GMV 24h data retrieved successfully

success · boolean

Example:

true

data · object

Show child attributes