商品列表

接口概述

该接口用于根据关键词搜索产品信息。

GET /api/v3/platform/product/list

请求参数

参数名 类型 必填 示例值 描述
pageNo Integer 是 1 页码，从1开始
pageSize Integer 是 50 每页记录数，最大50
keyword String 是 “手机” 搜索关键词
country String 否 “默认中文（zh）,繁体（cht），英文（en），韩文（kor）” 语言
sort String 否 “{“price”:”asc”}” 排序方式
categoryId String 否 “1234” 类目ID
categoryIdList String 否 “2,45” 类目id列表，英文逗号隔开，支持多个类目并集
priceStart Long 否 1000 价格区间开始
priceEnd Long 否 5000 价格区间结束

返回参数

名称 类型 描述 示例值
code Integer 返回状态码 0
result Boolean 返回结果 true
message String 返回描述 “success”
data Object 返回数据 -
» totalRecords Integer 总条数 分页
» totalPage Integer 总页码 分页
» pageSize Integer 分页 分页
» currentPage Integer 当前页 分页
» data Object 数据 数据
» » imageUrl String 图片地址 图片地址
» » subject String 中文标题 中文标题
» » subjectTrans String 外文标题 外文标题
» » offerId Long 商品id 2
» » isJxhy Boolean 是否精选货源 true
» » priceInfo Object 价格 1
» » » price String 批发价 10
» » » jxhyPrice String 代发精选货源价 10
» » » pfJxhyPrice String 批发精选货源价 10
» » » consignPrice String 一件代发价 10
» » » promotionPrice String 营销价 10
» » repurchaseRate String 复购率 10%
» » monthSold Integer 30天销量 1213
» » traceInfo String 向1688上报打点数据 object_id@620201390233^object_type@offer
» » isOnePsale Boolean 是否一件代发 true
» » sellerIdentities String[] 商家身份 [“super_factory-超级工厂”, “powerful_merchants-实力商家”, “tp_member-诚信通会员”]
» » offerIdentities String[] 商品标 [“yx-严选”, “select-跨境select”]
» » tradeScore String 商品交易评分 5.0
» » whiteImage String 商品白底图 商品白底图
» » promotionModel String 是否有营销信息 目前只透plus
» » » hasPromotion Boolean 是否有营销 true
» » » promotionType String 营销类型 plus
» » topCategoryId Long 一级类目 1
» » secondCategoryId Long 二级类目 2
» » thirdCategoryId Long 三级类目 3
» » isPatentProduct Boolean 是否专利商品 true
» » createDate String 商品上架时间 2024-04-20 08:00:00
» » modifyDate String 商品修改时间 2024-04-20 08:00:00
» » isSelect Boolean 跨境select货盘 true
» » minOrderQuantity Integer 最小起批量 1
» » sellerDataInfo Object 商品数据 1
» » » tradeMedalLevel String 卖家交易勋章等级 1
» » » compositeServiceScore String 综合服务体验分 1
» » » logisticsExperienceScore String 物流体验分 1
» » » disputeComplaintScore String 纠纷投诉处理分 1
» » » offerExperienceScore String 商品体验分 1
» » » afterSalesExperienceScore String 售后体验分 1
» » » consultingExperienceScore String 咨询体验分 1
» » » repeatPurchasePercent String 重复购买率 11
» » productSimpleShippingInfo Object 简略发货信息 1
» » » shippingTimeGuarantee String 发货时间保证 shipIn24Hours
» » token String 插件返佣token abc
» » promotionURL String 具有【AI跨境运营助手】模块的1688商品详情页链接 商品详情页链接

示例请求

  1. {
  2.   "pageNo": 1,
  3.   "pageSize": 20,
  4.   "keyword": "手机",
  5.   "sort": "{\"price\":\"asc\"}",
  6.   "categoryId": "1234",
  7.   "priceStart": 1000,
  8.   "priceEnd": 5000
  9. }

示例返回

  1. {
  2.   "code": 0,
  3.   "result": true,
  4.   "message": "Save Success",
  5.   "data": {
  6.     "totalRecords": 100,
  7.     "totalPage": 10,
  8.     "pageSize": 10,
  9.     "currentPage": 1,
  10.     "data": [
  11.       {
  12.         "imageUrl": "http://example.com/image.jpg",
  13.         "subject": "智能手机",
  14.         "subjectTrans": "Smartphone",
  15.         "offerId": 2,
  16.         "isJxhy": true,
  17.         "priceInfo": {
  18.           "price": "10",
  19.           "jxhyPrice": "10",
  20.           "pfJxhyPrice": "10",
  21.           "consignPrice": "10",
  22.           "promotionPrice": "10"
  23.         },
  24.         "repurchaseRate": "10%",
  25.         "monthSold": 1213,
  26.         "traceInfo": "object_id@620201390233^object_type@offer",
  27.         "isOnePsale": true,
  28.         "sellerIdentities": [
  29.           "super_factory-超级工厂",
  30.           "powerful_merchants-实力商家",
  31.           "tp_member-诚信通会员"
  32.         ],
  33.         "offerIdentities": [
  34.           "yx-严选",
  35.           "select-跨境select"
  36.         ],
  37.         "tradeScore": "5.0",
  38.         "whiteImage": "http://example.com/white.jpg",
  39.         "promotionModel": {
  40.           "hasPromotion": true,
  41.           "promotionType": "plus"
  42.         },
  43.         "topCategoryId": 1,
  44.         "secondCategoryId": 2,
  45.         "thirdCategoryId": 3,
  46.         "isPatentProduct": true,
  47.         "createDate": "2024-04-20 08:00:00",
  48.         "modifyDate": "2024-04-20 08:00:00",
  49.         "isSelect": true,
  50.         "minOrderQuantity": 1,
  51.         "sellerDataInfo": {
  52.           "tradeMedalLevel": "1",
  53.           "compositeServiceScore": "1",
  54.           "logisticsExperienceScore": "1",
  55.           "disputeComplaintScore": "1",
  56.           "offerExperienceScore": "1",
  57.           "afterSalesExperienceScore": "1",
  58.           "consultingExperienceScore": "1",
  59.           "repeatPurchasePercent": "11"
  60.         },
  61.         "productSimpleShippingInfo": {
  62.           "shippingTimeGuarantee": "shipIn24Hours"
  63.         },
  64.         "token": "abc",
  65.         "promotionURL": "http://example.com/product-detail.html"
  66.       }
  67.     ]
  68.   }
  69. }