Get Creator Marketplace Advanced Search Filters

POST

/affiliate_seller/202608/marketplace_creators/search/filter

This API allows you to obtain the advanced filters available in Seller Search Creator Marketplace. Because we are constantly releasing new filters which are specific to each country or region, this API serves as a way for developers to retrieve the latest available search filters.

Authorizations

• accessToken

Parameters

Query Parameters

shop_cipher

required

string

Identifies the shop. Obtain it from the Get Authorized Shops API.

Request Body

Media typeapplication/json

object

options

The filter option types to retrieve. If this field is omitted or empty, both option_list and sorters are returned as empty arrays.

Array<object>

object

option_type

Filter option type to retrieve. Possible values:

• OPTION_VERTICAL_PRO: Category Pro, a label for creators who regularly post about one product category and generated most of their sales in that category during the past 60 days.
• OPTION_LANGUAGE: Creator language.
• OPTION_CREATOR_LEVEL: Creator level based on GMV. The definition varies by country and is maintained by the TikTok Shop Creator team.
• OPTION_SORTER: Available creator-search sorting options, returned in sorters.
• OPTION_BRAND: Creator brand information. This value is not supported in DE, FR, IT, ES, IE, or JP.

string

Allowed values: OPTION_VERTICAL_PRO OPTION_LANGUAGE OPTION_CREATOR_LEVEL OPTION_SORTER OPTION_BRAND

Example

{
  "options": [
    {
      "option_type": "OPTION_SORTER"
    }
  ]
}

Responses

200

Success

Media typeapplication/json

object

code

Status code; 0 means success.

integer format: int64

message

Success or failure message.

string

request_id

Request log ID.

string

data

object

data

The available Creator Marketplace search-filter values and sorting options.

object

option_list

Creator Marketplace Advanced Filter Option List. If we return an empty object, it means this filter is not currently supported by your account or region.

Array<object>

object

option_type

The requested filter option type represented by this entry.

string

options

The available values for this filter option type.

Array<object>

object

id

Option id

string

name

The option name.

string

option_children

Children option detail list, used if the option has sub option choices

Array<object>

object

id

Children Option id

string

name

Children Option name

string

sorters

The available sorting options for Creator Marketplace search results.

Array<object>

object

algorithm_id

Sort algorithm id

string

name

Sort algorithm name

string

Example

{
  "code": 0,
  "data": {
    "data": {
      "option_list": [
        {
          "option_type": "OPTION_LANGUAGE",
          "options": [
            {
              "id": "1",
              "name": "English",
              "option_children": [
                {
                  "id": "12",
                  "name": "SubTypeName"
                }
              ]
            }
          ]
        }
      ],
      "sorters": [
        {
          "algorithm_id": "1",
          "name": "related"
        }
      ]
    }
  },
  "message": "Success",
  "request_id": "202203070749000101890810281E8C70B7"
}