> ## Documentation Index
> Fetch the complete documentation index at: https://growi.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Top TikTok Shop Products by GMV

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

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

```bash theme={null}
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

```json theme={null}
{
  "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


## OpenAPI

````yaml GET /stats/tik_tok_shop_products
openapi: 3.0.1
info:
  title: Growi API
  description: >-
    API documentation for Growi platform, showcasing the public tracking event
    endpoint
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.growi.io/api/public/v1
security:
  - bearerAuth: []
paths:
  /stats/tik_tok_shop_products:
    get:
      description: >-
        Retrieves TikTok Shop product-level Gross Merchandise Value (GMV) data
        with aggregated statistics
      parameters:
        - name: start_date
          in: query
          required: true
          example: 10/04/2025
          schema:
            type: string
            format: date
            default: 10/04/2025
          description: Start date in MM/DD/YYYY format
        - name: end_date
          in: query
          required: true
          example: 11/03/2025
          schema:
            type: string
            format: date
            default: 11/03/2025
          description: End date in MM/DD/YYYY format
      responses:
        '200':
          description: TikTok Shop Products data retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      tik_tok_shop_products:
                        type: object
                        properties:
                          products:
                            type: array
                            items:
                              type: object
                              properties:
                                product_id:
                                  type: string
                                  example: '1729548090545311965'
                                  description: >-
                                    Unique identifier for the TikTok Shop
                                    product
                                product_name:
                                  type: string
                                  example: >-
                                    Peach Perfect Inositol Multivitamin - Peach
                                    Perfect Myo-Inositol, D-Chiro Inositol,
                                    Omega 3 Fitness Healthcare
                                  description: Full name/title of the product
                                total_gmv:
                                  type: number
                                  format: float
                                  example: 127054.59
                                  description: >-
                                    Total Gross Merchandise Value (revenue)
                                    generated by this product
                                total_orders:
                                  type: integer
                                  example: 4086
                                  description: Total number of orders for this product
                                unique_videos:
                                  type: integer
                                  example: 456
                                  description: >-
                                    Number of unique videos that promoted this
                                    product
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````