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

TikTokapi

About

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

Documentation

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

[中文]

用途:

  • 根据关键词搜索商品
  • 支持分页加载更多结果

参数:

  • search_word: 搜索关键词 (必填)
  • offset: 偏移量,用于分页 (默认0)
  • page_token: 分页标记,用于获取下一页
  • region: 地区代码 (US/GB/SG/MY/PH/TH/VN/ID)

重要提示:

  • 由于接口风控原因,请务必将请求timeout设置为30秒
  • 如遇到400错误代码,请重试请求3次

返回数据结构:

{
    "code": 0,
    "message": "success",
    "data": {
        "products": [                // 商品列表(每页30个)
            {
                "product_id": "xxx",
                "title": "商品标题",
                "image": "商品图片URL",
                "product_price_info": {},  // 价格信息
                "rate_info": {},           // 评分信息
                "sold_info": {},           // 销量信息
                "seller_info": {},         // 卖家信息
                "seo_url": "商品SEO链接",
                "product_marketing_info": {} // 营销信息
            }
        ],
        "has_more": true,             // 是否有更多
        "load_more_params": {         // 分页参数
            "offset": 30,
            "page_token": "xxx",
            "api_source": 2
        }
    }
}

[English]

Purpose:

  • Search products by keyword
  • Support pagination to load more results

Parameters:

  • search_word: Search keyword (required)
  • offset: Offset for pagination (default 0)
  • page_token: Page token for next page
  • region: Region code (US/GB/SG/MY/PH/TH/VN/ID)

Important Notice:

  • 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": 0,
    "message": "success",
    "data": {
        "products": [                // Product list (30 per page)
            {
                "product_id": "xxx",
                "title": "Product title",
                "image": "Product image URL",
                "product_price_info": {},  // Price info
                "rate_info": {},           // Rating info
                "sold_info": {},           // Sales info
                "seller_info": {},         // Seller info
                "seo_url": "Product SEO URL",
                "product_marketing_info": {} // Marketing info
            }
        ],
        "has_more": true,             // Has more
        "load_more_params": {         // Pagination params
            "offset": 30,
            "page_token": "xxx",
            "api_source": 2
        }
    }
}

[示例/Example]

search_word = "labubu" offset = 0 page_token = "" region = "US"

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.

Try 搜索商品列表V1/Search products list V1

Test this model in the Sandbase Playground with your own prompts.

Open in Playground

Related Models