抖音精选联盟商品库

6 min read

基本信息

调试工具

  • service:cps-mesh.cpslink.douyin.material-products.get
  • 请求方式:POST

请求Header

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

公共参数

参数名称是否必须示例备注
app_key2312521媒体应用AppKey 查看获取方式
timestamp1596592757秒级时间戳
servicecps-mesh.cpslink.douyin.material-products.get接口服务名称
sign5D17CCCD5B29F98171D6D0D43136B366签名 详解

接口参数

参数名称是否必须示例备注
query关键词
page分页,1开始
page_size分页大小,最大20
share_status获取商品分销状态。1:仅返回可分销商品(默认);0:返回全量商品
category_id一级类目,多个逗号分隔,例:1,2
category_id2二级类目,多个逗号分隔,例:1,2
category_id3三级类目,多个逗号分隔,例:1,2
start_price起始价格, 1.00
end_price结束价格, 1.00
start_commission起始佣金, 1.00
end_commission结束佣金, 1.00
start_commission_rate起始佣金比例, 如10%, 传10
end_commission_rate结束佣金比例, 如20.5%, 传20.5
order_field0默认排序,1历史销量排序,2价格排序,3佣金金额排序,4佣金比例排序;
order_type排序方式:asc-升序(默认);desc-降序

请求示例

{
    "query": "string",
    "page": "string",
    "page_size": "string",
    "share_status": "string",
    "category_id": "string",
    "category_id2": "string",
    "category_id3": "string",
    "start_price": "string",
    "end_price": "string",
    "start_commission": "string",
    "end_commission": "string",
    "start_commission_rate": "string",
    "end_commission_rate": "string",
    "order_field": "string",
    "order_type": "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
        }
    ]
}