直播搜索

简介

通过达人unique_id/nickname/直播间标题搜索直播间

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

接口

    POST /live/v1/search

request body

字段	类型	必选	描述
keywords	string	否	搜索词
filter	object	否	过滤参数
orderby	object	否	排序参数
page	integer	否	默认:1
pagesize	integer	否	默认:10,最大:100,page * pagesize 不能大于60000
search_after	array	否	深度分页参数，与page参数二选一，分页查询数据总条数超过6万时需要用这个参数，下一页的参数值从上一页数据data.sort获取
lang	string	否	语言设置，仅支持以下语种，英语(默认值)：EN_US 印尼语： ID_ID 日语：JA_JP 泰语：TH_TH 越南语：VI_VN 西班牙语：ES_ES 法语：FR_FR 葡萄牙语：PT_BR 中文：ZH_CN

keywords

• 最大长度120字符 （默认：空）

filter可选值

字段	类型	必选	描述
region	string	否	国家/地区 ['US','GB','MX','ES','ID','VN','MY','TH','PH']
creator_category	integer	否	达人分类
product_category	integer	否	商品分类(一级)
live_type	integer	否	直播类型：1店铺播 2达人播
follower_range	object	否	粉丝数区间:{'min':1000,'max':1000}
viewer_range	object	否	观看人数区间:{'min':100,'max':100}
sold_range	object	否	直播间销量区间:{'min':100,'max':100}
start_time	timestamp[integer]	是	开播时间区间:{'min':1742976585,'max':1742976585}

orderby可选值

字段	必选	描述
start_time	否	开播时间(desc)
total_viewer_count	否	累计观看人数(desc)
total_units_sold	否	销量(desc)
total_gmv	否	销售额(desc)

request example

使用 page + pagesize分页
curl 'https://openapi.test.fastmoss.com/live/v1/search?client_id=XXX&timestamp=XXX&access_token=XXX&sign=XXX' \
--header 'Content-Type: application/json' \
{
    "keywords": "daisycabral_",
    "filter": {
        "region": "US",
        follower_range: {
            "min": 1000,
            "max": 10000
        },
        "product_category": 1,
        "live_type": 1,
        "start_time": {
            "min": 1759334400,  
            "max": 1759939200
        },
    },
    "orderby": [
      {
        "field": "start_time",
        "order": "desc",
      }
    ],
    "page": 1,
    "pagesize": 10
}

深度分页
curl 'https://openapi.test.fastmoss.com/live/v1/search?client_id=XXX&timestamp=XXX&access_token=XXX&sign=XXX' \
--header 'Content-Type: application/json' \
{
    "keywords": "daisycabral_",
    "filter": {
        "region": "US",
        follower_range: {
            "min": 1000,
            "max": 10000
        },
        "product_category": 1,
        "live_type": 1,
        "start_time": {
            "min": 1742966585,  
            "max": 1742976585
        },
    },
    "orderby": [
      {
        "field": "start_time",
        "order": "desc",
      }
    ],
    "search_after": [43500000],
    "pagesize": 10
}

response body

data.has_more

• 类型：integer
• 描述：是否有下一页数据，1是0否

data.list

字段	类型	描述
uid	string	达人uid
nickname	string	达人昵称
unique_id	string	达人unique_id
follower_count	integer	达人粉丝数
creator_region	string	达人region
room_id	string	直播间id
title	string	直播间标题
cover	string	直播间封面
start_time	integer	开播时间timestamp
end_time	integer	结束时间timestamp
duration	integer	直播时长（秒）
product_count	integer	直播间上架商品数
total_viewer_count	integer	累计观看人数
total_units_sold	integer	直播间销量
total_gmv	float	直播间销售额
currency	string	货币
uv_value	float	UV价值

data.sort 类型 array排序值

• 使用search_after深度分页时，往下翻一页需要传上一页返回的这个值

response example

{
  "code": 0,
  "msg": "success",
  "data": {
    "has_more": 1,
    "list": [
      {
        "uid": "123456",
        "unique_id": "hello",
        "nickname": "hello",
        "follower_count": 123,
        "creator_region": "US",
        "room_id": "12341234",
        "title": "welcome",
        "cover": "https://aaa.com/sss.jpeg",
        "start_time": 123412341,
        "end_time": 1234123412,
        "duration": 12342,
        "product_count": 12,
        "total_viewer_count": 1234,
        "total_units_sold": 123,
        "total_gmv": 1234,
        "currency": "USD",
        "uv_value": 1234
      }
    ],
    "sort": [
      20600000
    ]
  }
}