shop_search
搜索TikTok Shop店铺。支持按关键词或ID搜索,可按评分、销量、商品数等条件筛选。
Args:
keyword (string): 店铺关键词或名称
search_type (string): 搜索方式 N:ID,K:关键词
region (string): 国家/区域,默认US
category (string[]): 店铺类目列表
shop_type (string): 卖家类型
service_type (string): 运营模式
price_from (number): 价格下限
price_to (number): 价格上限
rating_from (number): 评分下限
rating_to (number): 评分上限
products_from (integer): 在售商品数下限
products_to (integer): 在售商品数上限
sales_volume_from (integer): 总销量下限
sales_volume_to (integer): 总销量上限
sales_volume_lst30d_from (integer): 近30天销量下限
sales_volume_lst30d_to (integer): 近30天销量上限
sales_volume_gr30d_from (number): 近30天销量增长率下限
sales_volume_gr30d_to (number): 近30天销量增长率上限
influencer_from (integer): 带货达人数下限
influencer_to (integer): 带货达人数上限
videos_from (integer): 带货视频数下限
videos_to (integer): 带货视频数上限
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
shopId (string): 店铺ID
shopName (string): 店铺名称
imageUrl (string): 店铺图片
link (string): 链接
region (string): 地区
shopType (string): 卖家类型
serviceType (string): 运营模式
fulfillmentType (string): 履行模式(自营/全托管)
crossBorder (integer): 是否跨境(0:本地, 1:跨境)
categories (string): 英文类目信息
cnCategories (string): 中文类目信息
rating (number): 评分
ratingRate (number): 4+评分占比
respondRate (number): 24小时回复率
shipRate (number): 2天内发货概率
shopRate (number): 超过的店铺占比
products (integer): 在售商品数
avgPrice (number): 在售商品平均价格
currency (string): 货币单位
totalSalesVolume (integer): 总销量
totalSales (number): 总销售额
salesVolumeLst30d (integer): 近30天销量
salesVolumeGr30d (number): 近30天销量增长率
salesLst30d (number): 近30天销售额
influencers (integer): 带货达人数
videos (integer): 带货视频数
kolspriteUrl (string): kolsprite详情链接
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | 国家/区域,默认US | |
| keyword | No | 店铺关键词或名称 | |
| category | No | 店铺类目列表,只支持传递一个,可选值通过product_category_list工具查询 | |
| page_num | No | 页码,默认1 | |
| price_to | No | 价格上限 | |
| page_size | No | 每页数量,默认20,最大100 | |
| rating_to | No | 评分上限 | |
| shop_type | No | 卖家类型 | |
| videos_to | No | 带货视频数上限 | |
| order_type | No | 排序方向:0降序,1升序,默认0 | |
| price_from | No | 价格下限 | |
| order_field | No | 排序字段 | |
| products_to | No | 在售商品数上限 | |
| rating_from | No | 评分下限 | |
| search_type | No | 搜索方式 N:ID,K:关键词 | |
| videos_from | No | 带货视频数下限 | |
| service_type | No | 运营模式 | |
| influencer_to | No | 带货达人数上限 | |
| products_from | No | 在售商品数下限 | |
| influencer_from | No | 带货达人数下限 | |
| sales_volume_to | No | 总销量上限 | |
| sales_volume_from | No | 总销量下限 | |
| sales_volume_gr30d_to | No | 近30天销量增长率上限 | |
| sales_volume_lst30d_to | No | 近30天销量上限 | |
| sales_volume_gr30d_from | No | 近30天销量增长率下限 | |
| sales_volume_lst30d_from | No | 近30天销量下限 |