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

# Discovery filters

> Returns the filters and sort orders you can use with Discover creators. `options` and `sorters` come live from TikTok and vary by region. Pass an option's `optionType` and chosen ids back as `advanced.options`, and a sorter's `algorithmId` as `advanced.sorterAlgorithmId`. `semantics` lists Growi's fixed values: page sizes, the GMV and units-sold buckets with readable labels, and notes on how the ranges read. This call doesn't count against the creator discovery quota.



## OpenAPI

````yaml api-reference/tik-tok-shop-openapi.json GET /tik_tok_shop/creators/discover/filters
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/creators/discover/filters:
    get:
      summary: Discovery filters
      description: >-
        Returns the filters and sort orders you can use with Discover creators.
        `options` and `sorters` come live from TikTok and vary by region. Pass
        an option's `optionType` and chosen ids back as `advanced.options`, and
        a sorter's `algorithmId` as `advanced.sorterAlgorithmId`. `semantics`
        lists Growi's fixed values: page sizes, the GMV and units-sold buckets
        with readable labels, and notes on how the ranges read. This call
        doesn't count against the creator discovery quota.
      parameters:
        - 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: >-
            TikTok's per-region options and sort orders, plus the fixed rules
            Growi applies.
          content:
            application/json:
              schema:
                type: object
                required:
                  - options
                  - sorters
                  - semantics
                properties:
                  options:
                    type: array
                    items:
                      type: object
                      properties:
                        optionType:
                          type: string
                        options:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              name:
                                type: string
                                nullable: true
                              children:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    name:
                                      type: string
                                      nullable: true
                  sorters:
                    type: array
                    items:
                      type: object
                      properties:
                        algorithmId:
                          type: string
                        name:
                          type: string
                          nullable: true
                  semantics:
                    type: object
                    description: Fixed enums, labels and notes.
              example:
                options:
                  - optionType: OPTION_LANGUAGE
                    options:
                      - id: '1'
                        name: English
                        children: []
                sorters:
                  - algorithmId: '1'
                    name: Recommended
                semantics:
                  pageSizes:
                    - 12
                    - 20
                  gmvRanges:
                    - value: GMV_RANGE_0_100
                      label: 0-100
                    - value: GMV_RANGE_100_1000
                      label: 100-1000
                    - value: GMV_RANGE_1000_10000
                      label: 1000-10000
                    - value: GMV_RANGE_10000_AND_ABOVE
                      label: 10000+
                  notes:
                    - >-
                      GMV and units sold are TikTok's four fixed buckets, not
                      continuous ranges.
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TikTokShopError'
        '403':
          description: >-
            The shop's TikTok authorization doesn't include this data (`code:
            scope_not_granted`), so the seller has to re-authorize the shop
          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:
    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.