[中文]

用途:

搜索TikTok Shop商品，支持高级筛选和排序

提供更多的筛选选项和排序方式

适合需要精细化筛选的场景

参数:

keyword: 搜索关键词 (必填)

offset: 分页偏移量，默认0

每页固定返回20个商品

如果响应中 has_more=1，使用 cursor 值进行下一页请求

region: 地区代码，Alpha-2 国家代码 (必填)

sort_by: 排序方式，默认 RELEVANCE

RELEVANCE: 按相关性排序（默认）

PRICE_ASC: 价格从低到高

PRICE_DESC: 价格从高到低

BEST_SELLERS: 最畅销

filters_data: 筛选数据，JSON数组格式字符串（可选）

可从首次响应的 filter_groups 字段获取可用筛选器

格式示例：

简单筛选按钮: {"type": 2, "value": "true"}

范围/多选: {"type": 8, "value_list": ["1,1000"]}

完整示例（价格和4星及以上）: [{"type": 2, "value": "true"},{"type": 8, "value_list": ["1,1000"]}]

重要提示:

每页固定返回20个商品

由于接口风控原因，请务必将请求timeout设置为30秒

如遇到400错误代码，请重试请求3次

返回数据结构:

{
    "code": 200,
    "data": {
        "products": [                  // 商品列表
            {
                "product_id": "xxx",
                "title": "商品标题",
                "image": "商品图片URL",
                "price": {             // 价格信息
                    "current_price": 19.99,
                    "original_price": 29.99,
                    "discount": "33% OFF"
                },
                "rating": {            // 评分信息
                    "average": 4.8,
                    "count": 1234
                },
                "sales": 5000,         // 销量
                "seller_info": {},     // 卖家信息
                "url": "商品链接"
            }
        ],
        "has_more": 1,                 // 是否有更多: 1=有, 0=无
        "cursor": "xxx",               // 下一页游标
        "filter_groups": [             // 可用的筛选器组
            {
                "group_name": "价格",
                "filters": [
                    {
                        "type": 8,
                        "name": "价格区间",
                        "options": [...]
                    }
                ]
            },
            {
                "group_name": "评分",
                "filters": [
                    {
                        "type": 2,
                        "name": "4星及以上",
                        "value": "true"
                    }
                ]
            }
        ],
        "total_count": 10000           // 总商品数
    }
}

[English]

Purpose:

Search TikTok Shop products with advanced filtering and sorting

Provides more filter options and sort methods

Suitable for scenarios requiring fine-grained filtering

Parameters:

keyword: Search keyword (required)

offset: Offset for pagination, default 0

Fixed 20 products per page

If has_more=1 in response, use cursor value for next page

region: Region code, Alpha-2 country code (required)

sort_by: Sort method, default RELEVANCE

RELEVANCE: Sort by relevance (default)

PRICE_ASC: Price low to high

PRICE_DESC: Price high to low

BEST_SELLERS: Best sellers

filters_data: Filter data, JSON array format string (optional)

Available filters can be obtained from filter_groups field in first response

Format examples:

Simple filter button: {"type": 2, "value": "true"}

Range/multiple select: {"type": 8, "value_list": ["1,1000"]}

Complete example (price and 4+ stars): [{"type": 2, "value": "true"},{"type": 8, "value_list": ["1,1000"]}]

Important Notice:

Fixed 20 products per page

Due to API rate limiting, please set request timeout to 30 seconds

If you encounter error code 400, please retry the request 3 times

Response Structure:

{
    "code": 200,
    "data": {
        "products": [                  // Product list
            {
                "product_id": "xxx",
                "title": "Product title",
                "image": "Product image URL",
                "price": {             // Price info
                    "current_price": 19.99,
                    "original_price": 29.99,
                    "discount": "33% OFF"
                },
                "rating": {            // Rating info
                    "average": 4.8,
                    "count": 1234
                },
                "sales": 5000,         // Sales count
                "seller_info": {},     // Seller info
                "url": "Product URL"
            }
        ],
        "has_more": 1,                 // Has more: 1=yes, 0=no
        "cursor": "xxx",               // Next page cursor
        "filter_groups": [             // Available filter groups
            {
                "group_name": "Price",
                "filters": [
                    {
                        "type": 8,
                        "name": "Price range",
                        "options": [...]
                    }
                ]
            },
            {
                "group_name": "Rating",
                "filters": [
                    {
                        "type": 2,
                        "name": "4 Stars & Up",
                        "value": "true"
                    }
                ]
            }
        ],
        "total_count": 10000           // Total product count
    }
}

[示例/Example]

keyword = "baby"
offset = 0
region = "US"
sort_by = "PRICE_ASC"
filters_data = '[{"type": 2, "value": "true"},{"type": 8, "value_list": ["1,1000"]}]'

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Unprocessable Entity

搜索商品列表V3/Search products list V3

[中文]#

用途:#

参数:#

重要提示:#

返回数据结构:#

[English]#

Purpose:#

Parameters:#

Important Notice:#

Response Structure:#

[示例/Example]#

Request