Skip to main content
GET
/
stats
/
tik_tok_shop_gmv_24h
cURL
curl --request GET \
  --url https://api.growi.io/api/public/v1/stats/tik_tok_shop_gmv_24h \
  --header 'Authorization: Bearer <token>'
{
  "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
      }
    ]
  }
}
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

ParameterTypeDescriptionRequired
start_dateStringStart date in MM/DD/YYYY formatYes
end_dateStringEnd date in MM/DD/YYYY formatYes

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

FieldTypeDescription
dateStringThe date for this data point (YYYY-MM-DD format)
last_dateIntegerUnix timestamp for the corresponding date in the previous period
currentStringGMV for the current date (formatted as currency string)
lastStringGMV for the corresponding date in the previous period (formatted as currency string)
totalStringCumulative GMV total for the current period (formatted as currency string)
last_totalStringCumulative GMV total for the previous period (formatted as currency string)
order_countIntegerNumber of orders on the current date
last_order_countIntegerNumber of orders on the corresponding date in the previous period
total_order_countIntegerCumulative order count for the current period
last_total_order_countIntegerCumulative 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

TikTok Shop GMV 24h data retrieved successfully

success
boolean
Example:

true

data
object