商品文案

				
API市场> 搜索相关API >联盟搜索
联盟搜索 (联盟关键词商品查询) 免费
API类型: 搜索相关API 使用人数:7200+
槽点建议
API接口说明: 通过关键词搜索京推推商品库和京东联盟商品库内所有商品,您可以自由控制搜索条件,检索最符合您需求的商品,支持按SKUID、关键词、商品链接、店铺名称搜索,同时也支持按价格、佣金、销量等参数排序,支持SKU批量搜索(若信息页展示参数无返回则说明无该信息)
API使用建议: 构建商品详情页建议使用本接口,可与【商品详情页】一起使用
应用场景: 可应用于媒体内搜索框搜京东全站构建、查券机器人等商品库搭建,也可用于构建单品的详情页
槽点建议
版本号:{{item.version}}
接口地址: {{paramData.address}}
请求数据: {{paramData.sample}}
请求方式: {{paramData.type}}
支持格式: {{paramData.datatype}}
系统参数
名称 类型 必填 示例 说明
{{item.name}}
复制
{{item.type}} {{item.mandat}} {{item.example}} {{item.explain}}
请求参数说明
名称 类型 必填 示例 说明
{{item.name}}
复制
{{item.type}} {{item.mandat}} {{item.example}} {{item.explain}}
返回参数说明
名称 类型 示例值 说明
{{item.name}}
复制
{{item.type}} {{item.mandat}} {{item.explain}}
JSON返回示例

    V3版本 更新时间: 2024-04-12 11:23:11

    V3更新内容

    返回参数: 
    1、新增字段:itemId,为联盟商品id 
    2、skuId字段:不返回 
    3、similarSkuList字段:不返回 
    4、materialUrl字段:当入参场景2且有对应场景权限时,返回京东商品链接,其他返回联盟商品链接

    v3版本 更新时间: 2021-02-25 11:06:03

    v3更新内容

    该版本功能与v1版本基本一致,该版本返回参数为京推推开放平台统一参数

    一、请求参数
    原shopId调整为shop_id:店铺ID筛选

    二、返回参数
    1   原discount调整为discount_price:优惠券面额
    2   原link调整为discount_link:领券链接
    3   原platformType调整为platform:券使用平台
    4   原getStartTime调整为get_start_time:优惠券领取开始时间
    5   原getEndTime调整为get_end_time:优惠券领取到期时间
    6   原materialUrl调整为goods_link:京东商品链接
    7   原shopId调整为shop_id:店铺id
    8   新增isInputCoupon:入参couponUrl优惠券链接搜索对应的券(1 是 ;0 否)

    v1版本 更新时间: 2021-02-25 11:03:57

    v1更新内容

    返回参数:
     1   新增promotionLabelInfoList:商品促销标签集
                 promotionLabelInfo:商品促销标签
                 promotionLabel:商品促销文案
                 lableName:促销标签名称
                 startTime:促销开始时间
                 endTime:促销结束时间
                 promotionLableId:促销ID
    2   新增secondPriceInfoList:双价格
                  secondPriceInfo:双价格信息
                  secondPriceType:双价格类型
                  secondPrice:价格

    v1版本 更新时间: 2020-12-25 20:59:24

    v1更新内容

    2020年12月25日更新

    一、请求参数
    1  增加图书编号(isbn)
    2  增加主商品spuId(spuId)
    3  增加优惠券链接(couponUrl)
    4  增加资源位17:极速版商品(eliteType)
    二、返回参数
    1  增加优惠券信息返回(是否为入参优惠券对应券信息isInputCoupon)
    2  增加图片信息返回(白底图whiteImage)
    3  增加店铺信息返回(京东好店shopLabel、用户评价评分userEvaluateScore、用户评价评级commentFactorScoreRankGrade、物流履约评分logisticsLvyueScore、物流履约评级logisticsFactorScoreRankGrade、售后服务评分afterServiceScore、售后服务评级afsFactorScoreRankGrade、店铺风向标scoreRankRate)
    4  增加图书信息返回(图书编号isbn)
    5  增加扩展信息(尺寸size、颜色color、自定义属性spec、自定义属性名称specName、库存状态stockState、极速版商品eliteType)
    6  增加商品标签(0:不支持; 1或null:支持7天无理由退货; 2:支持90天无理由退货; 4:支持15天无理由退货; 6:支持30天无理由退货is7ToReturn、放心购商品fxg、放心购商品子标签fxgServiceList、服务名称serviceName)

    v1版本 更新时间: 2020-12-25 20:58:52

    v1更新内容

    2020年10月24日更新

    该版本同步联盟搜索接口
    一、请求参数
    1    增加一、二、三级类目搜索(cid1、cid2、cid3)
    2    增加多sku搜索(skuIds)
    3    增加京东品牌code筛选(brandCode)
    4    增加内容商品查询筛选(hasCountent)
    5    增加最优券商品查询(hasBestCoupon)
    6    增加pid查询
    7    增加筛选参数(fieIds:videoInfo视频信息;hotWords热词;similar相似推荐商品;documentInfo段子信息)
    8    增加微信京东购物小程序禁售商品过滤规则(2OTC商品;3加油卡;4游戏充值卡;5合约机;6京保养;7虚拟组套;8定制商品)
    9    增加京喜商品类型筛选(1京喜;2京喜工厂直供;3京喜优选)
    10  增加店铺评分筛选(支持传入0.0、2.5、3.0、3.5、4.0、4.5、4.9,默认为空表示不筛选评分)
    二、返回参数
    1    商品SKU由原goods_id改为skuId
    2    京东商品原标题由原short_name改为skuName
    3    京东商品链接由原goods_link改为materialUrl
    4    增加30天支出佣金金额inOrderComm30Days
    5    京东_品牌code由原jd_brandCode改为brandCode
    6    京东_品牌名称由原jd_brandName改为brandName
    7    增加佣金信息返回参数(commission佣金;couponCommission券后佣金;plusCommissionShare plus会员佣金)
    8    商品佣金比例由原commission改为commissionshare
    9    增加券相关信息返回参数(bindType券种类;platformType增加券使用平台;quota增加券消费限额;useStartTime券有效开始时间;useEndTime券有效结束时间;isBest最优优惠券;hotValue券热度)
    10  增加价格相关信息返回参数(lowestprice促销价;lowestPriceType促销价类型;lowestCouponPrice券后价;historyPriceDay历史最低价天数)
    11  增加视频信息返回参数(video视频信息;width宽;high高;imageUrl视频图片地址;videoType主图、商详;playUrl播放地址;playType视频清晰度;duration视频时长)
    12  增加评价信息返回参数(content评价内容;urlInfo图片合集;url图片链接地址;jxFlags京喜商品类型;documentInfo商品段子信息;document描述文案;discount优惠力度文案;hotWords热搜词;similarSkuList相似商品skuId集合)
    错误码 说明
    0 请求成功
    1000 appid或appkey错误
    2000 API次数调用超过上限
    3000 API权限不足