小店搜索

简介

通过店铺名称搜索店铺信息，支持以下功能：

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

接口信息

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','ID','VN','MY','TH','PH']
shop_name	string	否	店铺名称
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.test.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
name	string	名称
uid	string	uid
region	string	region

response 示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "seller_id": "7495134004458195071",
        "uid": "6998429985887667205",
        "name": "Halara shop",
        "region": "US"
      },
      {
        "seller_id": "7495304734897637668",
        "uid": "6945317262698595329",
        "name": "Halara US",
        "region": "US"
      },
      {
        "seller_id": "7495394207367596894",
        "uid": "7272300686909162538",
        "name": "Halara Glam",
        "region": "US"
      },
      {
        "seller_id": "7495397250347796961",
        "uid": "",
        "name": "Halara CA",
        "region": "US"
      },
      {
        "seller_id": "7495397356525292541",
        "uid": "",
        "name": "Halara usa1",
        "region": "US"
      },
      {
        "seller_id": "7495470591119166378",
        "uid": "7311218764057838638",
        "name": "Halara Workleisure",
        "region": "US"
      },
      {
        "seller_id": "7495586497275202294",
        "uid": "7034022154347447342",
        "name": "Halara Sports",
        "region": "US"
      }
    ],
    "total": 7
  },
  "message": "",
  "timestamp": 1744797551,
  "request_id": "6f12def3-6946-8c55-ef98-2c2b37af867e"
}