product_search
搜索TikTok Shop商品。支持按关键词或ID搜索，可按价格、销量、评分等条件筛选。
Args:
keyword (string): 关键词或产品标题
search_type (string): 搜索方式 N:ID，K:关键词
region (string): 国家/区域，默认US
cat_ids (string[]): 类目ID列表
exclude_keyword (string): 排除关键词
ft (string): 履约类型 fbt:全托管 pop:自运营
lt (string): 物流类型 local:本地 crossborder:跨境
shop_id (string): 店铺ID
price_from (number): 价格下限
price_to (number): 价格上限
rating_from (number): 评分下限
rating_to (number): 评分上限
reviews_from (integer): 评论数下限
reviews_to (integer): 评论数上限
sales_volume_from (integer): 总销量下限
sales_volume_to (integer): 总销量上限
sales_volume_lst7d_from (integer): 近7天销量下限
sales_volume_lst7d_to (integer): 近7天销量上限
sales_volume_lst30d_from (integer): 近30天销量下限
sales_volume_lst30d_to (integer): 近30天销量上限
sales_lst30d_from (number): 近30天销售额下限
sales_lst30d_to (number): 近30天销售额上限
sales_volume_gr7d_from (number): 7天增长率下限
sales_volume_gr7d_to (number): 7天增长率上限
sales_volume_gr30d_from (number): 30天增长率下限
sales_volume_gr30d_to (number): 30天增长率上限
influencer_from (integer): 带货达人数下限
influencer_to (integer): 带货达人数上限
videos_from (integer): 带货视频数下限
videos_to (integer): 带货视频数上限
listing_date_from (string): 上架时间起始，格式yyyy-MM-dd(如2024-01-01)
listing_date_to (string): 上架时间截止，格式yyyy-MM-dd(如2024-12-31)
order_field (string): 排序字段
order_type (integer): 排序方向：0降序，1升序，默认0
page_num (integer): 页码，默认1
page_size (integer): 每页数量，默认20，最大100
Returns:
object: 分页结果。
外层: {code(string): 状态码, message(string): 提示信息, success(boolean): 是否成功, data(object): 分页数据}
data: {total(integer): 数据总数, pageNum(integer): 当前页码, pageSize(integer): 页容, list(object[]): 结果集}
list元素(商品):
id (string): 产品ID
title (string): 产品标题
imageUrl (string): 产品图片
link (string): 商品链接
catId (string): 类目ID
catName (string): 类目名称
cnCatName (string): 中文类目名称
price (number): 现价
originalPrice (number): 原价
currency (string): 货币
rating (number): 评分
reviews (integer): 评论数
ft (string): 履约类型
lt (string): 物流类型
region (string): 区域
listingDate (string): 上架时间
totalSalesVolume (integer): 总销量
totalSales (number): 总销售额
salesVolumeLst7d (integer): 近7天销量
salesVolumeLst30d (integer): 近30天销量
salesVolumeGr7d (number): 近7天销量增长率
salesVolumeGr30d (number): 近30天销量增长率
salesLst7d (number): 近7天销售额
salesLst30d (number): 近30天销售额
influencers (integer): 带货达人数
videos (integer): 带货视频数
lives (integer): 带货直播数
shopId (string): 店铺ID
shopName (string): 店铺名称
shopImageUrl (string): 店铺图片
shopProducts (integer): 店铺商品数
shopSalesVolume (integer): 店铺销量
kolspriteUrl (string): kolsprite详情链接
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ft | No | 履约类型 fbt:全托管 pop:自运营 | |
| lt | No | 物流类型 local:本地 crossborder:跨境 | |
| region | No | 国家/区域，默认US | |
| cat_ids | No | 类目ID列表，只支持传递一个，可选值通过product_category_list工具查询 | |
| keyword | No | 关键词或产品标题 | |
| shop_id | No | 店铺ID | |
| page_num | No | 页码，默认1 | |
| price_to | No | 价格上限 | |
| page_size | No | 每页数量，默认20，最大100 | |
| rating_to | No | 评分上限 | |
| videos_to | No | 带货视频数上限 | |
| order_type | No | 排序方向：0降序，1升序，默认0 | |
| price_from | No | 价格下限 | |
| reviews_to | No | 评论数上限 | |
| order_field | No | 排序字段 | |
| rating_from | No | 评分下限 | |
| search_type | No | 搜索方式 N:ID，K:关键词 | |
| videos_from | No | 带货视频数下限 | |
| reviews_from | No | 评论数下限 | |
| influencer_to | No | 带货达人数上限 | |
| exclude_keyword | No | 排除关键词 | |
| influencer_from | No | 带货达人数下限 | |
| listing_date_to | No | 上架时间截止，格式yyyy-MM-dd(如2024-12-31) | |
| sales_lst30d_to | No | 近30天销售额上限 | |
| sales_volume_to | No | 总销量上限 | |
| listing_date_from | No | 上架时间起始，格式yyyy-MM-dd(如2024-01-01) | |
| sales_lst30d_from | No | 近30天销售额下限 | |
| sales_volume_from | No | 总销量下限 | |
| sales_volume_gr7d_to | No | 7天增长率上限 | |
| sales_volume_gr30d_to | No | 30天增长率上限 | |
| sales_volume_lst7d_to | No | 近7天销量上限 | |
| sales_volume_gr7d_from | No | 7天增长率下限 | |
| sales_volume_lst30d_to | No | 近30天销量上限 | |
| sales_volume_gr30d_from | No | 30天增长率下限 | |
| sales_volume_lst7d_from | No | 近7天销量下限 | |
| sales_volume_lst30d_from | No | 近30天销量下限 |