logoDuoMai

·

Open Platform

Old Version

穿山甲直播间搜索接口

5 min read

基本信息

调试工具

  • service：cps-mesh.open.csj.lives.get
  • 请求方式：POST

请求Header

Header参数是否必须示例备注
Content-Type是application/json

公共参数

参数名称是否必须示例备注
app_key是2312521媒体应用AppKey 查看获取方式
timestamp是1596592757秒级时间戳
service是cps-mesh.open.csj.lives.get接口服务名称
sign是5D17CCCD5B29F98171D6D0D43136B366签名 详解

接口参数

参数名称是否必须示例备注
query否商品关键词
page否分页，1开始
page_size否分页大小,最大20
sort_by否排序字段: 1-综合；2-销量；3-佣金率；4-粉丝数。不填默认为1
sort_type否排序方式：0-降序；1-升序。不填默认为0。若sort_by为1， 则此字段无意义
status否直播间状态筛选：0-在播和不在播，1-在播，2-不在播。默认为1，代表只出在播直播间
author_info否达人昵称/达人uid
need_products否是否需要返回商品:1-返回，0-不返回。默认为1，代表返回商品信息

请求示例

{
    "query": "string",
    "page": "string",
    "page_size": "string",
    "sort_by": "string",
    "sort_type": "string",
    "status": "string",
    "author_info": "string",
    "need_products": "string"
}

返回参数

名称类型是否必须默认值备注其他信息
statusinteger非必须状态code
messagestring非必须错误信息
dataobject []非必须

item 类型: object

├─ item_idstring非必须商品原始ID
├─ item_pidstring非必须同款商品不同sku的主id，部分商家有值
├─ item_titlestring非必须商品标题
├─ item_picturestring非必须商品主图
├─ item_small_picturesstring []非必须商品小图 [string]

item 类型: string

├─ 非必须
├─ item_volumestring非必须商品销量
├─ activity_infostring非必须活动折扣信息
├─ item_urlstring非必须商品URL
├─ item_pricestring非必须商品价格
├─ coupon_pricestring非必须优惠券面额
├─ couponstring非必须优惠券/链接
├─ coupon_quotastring非必须优惠券限额
├─ item_final_pricestring非必须券后价
├─ categorystring非必须类目
├─ brandstring非必须品牌
├─ commission_ratestring非必须佣金比例
├─ commission_amountstring非必须佣金金额
├─ item_platformstring非必须商品平台
├─ coupon_start_timestring非必须优惠开始时间，10位unix时间戳
├─ coupon_end_timestring非必须优惠结束时间，10位unix时间戳
├─ seller_idstring非必须商家Id
├─ seller_namestring非必须商家名字
├─ seller_typeinteger非必须商家类型 0 普通，1自营
├─ in_stockboolean非必须是否有库存
├─ sharableboolean非必须是否可分销(抖音商品)
├─ good_comment_ratestring非必须好评率百分比，部分商家有值
├─ commentsinteger非必须商品评论数，部分商家有值
├─ extra_infoobject非必须原始信息
├─ coupon_use_start_timestring非必须券有效使用开始时间，10位unix时间戳
├─ coupon_use_end_timestring非必须券有效使用结束时间，10位unix时间戳
├─ seller_infoobject非必须店铺相关评分
├─ seller_scorestring非必须店铺评分
├─ product_scorestring非必须商品评分
├─ logistics_scorestring非必须物流评分
├─ service_scorestring非必须服务评分
├─ product_scorestring非必须当前商品评分
├─ order_num30daysinteger非必须30天订单量
├─ view_num30daysinteger非必须30天浏览量
├─ kol_num30daysinteger非必须30天推广达人量

返回示例

{
    "status": 0,
    "message": "string",
    "data": [
        {
            "item_id": "string",
            "item_pid": "string",
            "item_title": "string",
            "item_picture": "string",
            "item_small_pictures": [
                "string"
            ],
            "item_volume": "string",
            "activity_info": "string",
            "item_url": "string",
            "item_price": "string",
            "coupon_price": "string",
            "coupon": "string",
            "coupon_quota": "string",
            "item_final_price": "string",
            "category": "string",
            "brand": "string",
            "commission_rate": "string",
            "commission_amount": "string",
            "item_platform": "string",
            "coupon_start_time": "string",
            "coupon_end_time": "string",
            "seller_id": "string",
            "seller_name": "string",
            "seller_type": 0,
            "in_stock": true,
            "sharable": true,
            "good_comment_rate": "string",
            "comments": 0,
            "extra_info": {},
            "coupon_use_start_time": "string",
            "coupon_use_end_time": "string",
            "seller_info": {
                "seller_score": "string",
                "product_score": "string",
                "logistics_score": "string",
                "service_score": "string"
            },
            "product_score": "string",
            "order_num30days": 0,
            "view_num30days": 0,
            "kol_num30days": 0
        }
    ]
}