> ## 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.

# Get TikTok Shop GMV 24h

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

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

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

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


## OpenAPI

````yaml GET /stats/tik_tok_shop_gmv_24h
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_gmv_24h:
    get:
      description: >-
        Retrieves TikTok Shop Gross Merchandise Value (GMV) data with daily
        breakdown and comparison to previous period
      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 GMV 24h data retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      tik_tok_shop_gmv_24h:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                              example: '2025-10-04'
                              description: The date for this data point (YYYY-MM-DD format)
                            last_date:
                              type: integer
                              example: 1756872000
                              description: >-
                                Unix timestamp for the corresponding date in the
                                previous period
                            current:
                              type: string
                              example: $1,985.10
                              description: >-
                                GMV for the current date (formatted as currency
                                string)
                            last:
                              type: string
                              example: $2,684.88
                              description: >-
                                GMV for the corresponding date in the previous
                                period
                            total:
                              type: string
                              example: $55,991.01
                              description: Cumulative GMV total for the current period
                            last_total:
                              type: string
                              example: $78,445.73
                              description: Cumulative GMV total for the previous period
                            order_count:
                              type: integer
                              example: 68
                              description: Number of orders on the current date
                            last_order_count:
                              type: integer
                              example: 99
                              description: >-
                                Number of orders on the corresponding date in
                                the previous period
                            total_order_count:
                              type: integer
                              example: 1759
                              description: Cumulative order count for the current period
                            last_total_order_count:
                              type: integer
                              example: 2489
                              description: Cumulative order count for the previous period
        '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

````