京东商品库搜索接口

6 min read

基本信息

调试工具

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

请求Header

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

公共参数

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

接口参数

参数名称是否必须示例备注
query查询关键字
page页码
page_size分页大小 最大200
item_ids商品ids串,多个英文逗号分隔,内容来自各大平台的item_id
seller_id店铺id
category_id分类id
category_id2分类id2
category_id3分类id3
order_field排序字段 commission_rate 佣金比例 price价格 volume 销量
order_type排序类型 asc desc
start_price起始价格 10.0
end_price结束价格 29.0
start_commission_rate起始佣金比例 10
end_commission_rate结束佣金比例 100
is_self是否自营 是1 否0 京东,天猫,苏宁为自营店。拼多多为品牌店 默认全部
is_coupon是否有优惠券 是1 否0
is_hot【已废弃】是否热门:是1否0
max_coupon是否返回最大优惠商品 是1 否0

请求示例

{
    "query": "string",
    "page": "string",
    "page_size": "string",
    "item_ids": "string",
    "seller_id": "string",
    "category_id": "string",
    "category_id2": "string",
    "category_id3": "string",
    "order_field": "string",
    "order_type": "string",
    "start_price": "string",
    "end_price": "string",
    "start_commission_rate": "string",
    "end_commission_rate": "string",
    "is_self": "string",
    "is_coupon": "string",
    "is_hot": "string",
    "max_coupon": "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
        }
    ]
}