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

# SKU performance

> Returns one SKU's GMV, items sold and SKU orders per day or as one total, from TikTok's analytics. Each interval is split by channel (`LIVE`, `VIDEO`, `PRODUCT_CARD`) in `gmvByChannel` and `itemsSoldByChannel`.

`start_date` is inclusive and `end_date` is exclusive (YYYY-MM-DD, shop timezone), so pass the day after the last day you want. Interval `endDate` values are exclusive too. TikTok rejects windows starting more than about 180 days back. `granularity` is `1D` (default) or `ALL`. `currency` is `USD` or `LOCAL` (TikTok's default). `latestAvailableDate` shows the newest day TikTok has data for.



## OpenAPI

````yaml api-reference/tik-tok-shop-openapi.json GET /tik_tok_shop/analytics/skus/{skuId}/performance
openapi: 3.0.3
info:
  title: 'Growi API: TikTok Shop'
  version: 1.0.0
  description: >-
    Generated by scripts/gen_tik_tok_shop.rb from Growi's TikTok Shop route
    table.
servers:
  - url: https://api.growi.io/api/public/v1
security:
  - bearerAuth: []
paths:
  /tik_tok_shop/analytics/skus/{skuId}/performance:
    get:
      summary: SKU performance
      description: >-
        Returns one SKU's GMV, items sold and SKU orders per day or as one
        total, from TikTok's analytics. Each interval is split by channel
        (`LIVE`, `VIDEO`, `PRODUCT_CARD`) in `gmvByChannel` and
        `itemsSoldByChannel`.


        `start_date` is inclusive and `end_date` is exclusive (YYYY-MM-DD, shop
        timezone), so pass the day after the last day you want. Interval
        `endDate` values are exclusive too. TikTok rejects windows starting more
        than about 180 days back. `granularity` is `1D` (default) or `ALL`.
        `currency` is `USD` or `LOCAL` (TikTok's default). `latestAvailableDate`
        shows the newest day TikTok has data for.
      parameters:
        - name: skuId
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9]{1,32}$
          description: TikTok SKU id.
        - name: start_date
          in: query
          required: true
          schema:
            type: string
            format: date
          description: Window start, YYYY-MM-DD inclusive (shop timezone).
        - name: end_date
          in: query
          required: true
          schema:
            type: string
            format: date
          description: >-
            Window end, YYYY-MM-DD EXCLUSIVE (TikTok's end_date_lt semantics).
            TikTok rejects windows starting more than ~180 days back.
        - name: granularity
          in: query
          required: false
          schema:
            type: string
            enum:
              - 1D
              - ALL
            default: 1D
          description: 1D = one interval per day, ALL = one aggregate interval.
        - name: currency
          in: query
          required: false
          schema:
            type: string
            enum:
              - USD
              - LOCAL
          description: TikTok defaults to LOCAL.
        - name: organization_id
          in: query
          required: false
          schema:
            type: integer
          description: >-
            Use the TikTok Shop of this child brand (organization id) of your
            API key's organization
      responses:
        '200':
          description: The SKU's intervals.
          content:
            application/json:
              schema:
                type: object
                properties:
                  skuId:
                    type: string
                    nullable: true
                  productId:
                    type: string
                    nullable: true
                  latestAvailableDate:
                    type: string
                    nullable: true
                  intervals:
                    type: array
                    items:
                      type: object
                      properties:
                        startDate:
                          type: string
                          nullable: true
                        endDate:
                          type: string
                          nullable: true
                          description: Exclusive.
                        gmv:
                          $ref: '#/components/schemas/Money'
                        gmvByChannel:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                description: LIVE | VIDEO | PRODUCT_CARD
                              amount:
                                type: string
                                nullable: true
                              currency:
                                type: string
                                nullable: true
                        itemsSold:
                          type: integer
                          nullable: true
                        itemsSoldByChannel:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                              count:
                                type: integer
                                nullable: true
                        skuOrders:
                          type: integer
                          nullable: true
              example:
                skuId: '1729000000000000101'
                productId: '1729000000000000100'
                intervals:
                  - startDate: '2026-09-01'
                    endDate: '2026-09-02'
                    gmv:
                      amount: '149.94'
                      currency: USD
                    gmvByChannel:
                      - type: VIDEO
                        amount: '99.96'
                        currency: USD
                      - type: PRODUCT_CARD
                        amount: '49.98'
                        currency: USD
                    itemsSold: 6
                    itemsSoldByChannel:
                      - type: VIDEO
                        count: 4
                      - type: PRODUCT_CARD
                        count: 2
                    skuOrders: 6
                latestAvailableDate: '2026-09-27'
        '400':
          description: Invalid id or dates
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '404':
          description: >-
            `organization_id` isn't an active child brand of your organization,
            or the record you asked for doesn't exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '422':
          description: >-
            No TikTok Shop is connected for this organization. A parent
            organization whose shops sit on its child brands has to pass
            `organization_id`. Also returned when the shop isn't connected
            through TikTok's official API (`code: unsupported_on_web_only_shop`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '429':
          description: >-
            Rate limited: one call every 2 seconds and an hourly cap per API
            key. See `Retry-After` and the `X-RateLimit-*` headers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '502':
          description: >-
            TikTok refused or failed. `error` is a fixed message and `code`
            names the failure when there is one
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
components:
  schemas:
    Money:
      type: object
      nullable: true
      description: 'TikTok''s money object: amount as a decimal string, ISO currency code.'
      properties:
        amount:
          type: string
          nullable: true
        currency:
          type: string
          nullable: true
    TikTokShopError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: What went wrong
        code:
          type: string
          description: Machine-readable reason, when there is one
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.