小店搜索

简介

通过关键词或过滤条件筛选店铺，支持以下功能：

• 支持模糊搜索
• 支持设置过滤参数
• 支持自定义结果排序方式

接口信息

POST /shop/v1/search

request body

字段	类型	必选	描述
keywords	string	否	搜索词
filter	object	否	过滤参数
orderby	object	否	排序参数
page	integer	否	默认:1
pagesize	integer	否	默认:10

filter 可选值

字段	类型	必选	描述
region	string	否	国家/地区 ['US','GB','MX','ES','DE','IT','FR','ID','VN','MY','TH','PH','BR','JP','SG']
shop_name	string	否	店铺名称
brand_name	string	否	品牌名称
seller_id	string	否	店铺id
rating_range	object	否	店铺评分范围:{"min":1,"max":123}
creator_reange	string	否	关联达人数量范围:{"min":1,"max":123}
is_sshop	boolean	否	是否为S店铺
is_local	boolean	否	是否本土店铺
category_id	integer	否	主营分类

orderby 可选值

字段	必选	描述
day7_units_sold	否	近7天销量(desc)
day7_gmv	否	近7天销售额(desc)
total_units_sold	否	总销量(desc)
total_gmv	否	总销售额(desc)

request example

curl 'https://openapi.fastmoss.com/shop/v1/search?client_id=XXX&timestamp=XXX&access_token=XXX&sign=XXX ' \
--header 'Content-Type: application/json' \
{
    "keywords":"",
    "filter": {
        "region": "US",
        "shop_name": "xxxx",
    },
    "page": 1,
    "pagesize": 10,
}

response body

data.total

结果总条数

data.list

字段	类型	描述
seller_id	string	店铺 id
category_id	array	商品分类
uid	string	uid
region	string	region
name	string	店铺名称
brand	string	品牌
shop_rating	integer	店铺评分
total_units_sold	integer	总销量
total_gmv	integer	总销售额
day7_units_sold	integer	近7天销量
day7_total_gmv	integer	近7天销售额
is_local	integer	是否本土店铺
is_sshop	integer	是否S店铺
on_sale_product_count	integer	在售商品数量
affiliate_creator_count	integer	关联达人数量

response 示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "seller_id":"7496169538916026807",
        "category_id":["3","839944"],
        "uid":"7502001270334194734",
        "region":"US",
        "name":"YOUNG",
        "brand":"",
        "shop_rating":37,
        "total_units_sold":0,
        "total_gmv":0,
        "day7_units_sold":0,
        "day7_total_gmv":0,
        "is_local":0,
        "is_sshop":0,
        "on_sale_product_count":1573,
        "affiliate_creator_count":0
      }
    ],
    "total": 1
  },
  "message": "",
  "timestamp": 1744797551,
  "request_id": "6f12def3-6946-8c55-ef98-2c2b37af867e"
}