Top TikTok Shop Products by GMV

Retrieves TikTok Shop product-level Gross Merchandise Value (GMV) data with aggregated statistics

GET /stats/tik_tok_shop_products

cURL

cURL

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

200

{
  "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
        }
      ]
    }
  }
}

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

200

application/json

TikTok Shop Products data retrieved successfully

success · boolean

Example:

true

data · object

Show child attributes