商品搜索

在支持的电商平台（淘宝、1688）上分页搜索商品。

POSThttps://open.hiobuy.com/api/client/third-purchase/search

若实际 API 基地址不同，请替换 `https://open.hiobuy.com`。

请求头

名称必填类型说明
X-Uuid是string商户 UUID（账户唯一标识）
Language否string商品标题等信息的展示语言，默认 `zh_CN`。见 支持的语言。

支持的语言

平台代码语言
淘宝zh_CN简体中文
淘宝en_US英语
淘宝vi_VN越南语
1688zh_CN简体中文
1688en_US英语
1688ko_KR韩语
1688ja日语
1688ru_RU俄语
1688vi_VN越南语
1688es_ES西班牙语
1688ar阿拉伯语

请求体

名称必填类型说明
keyword是string搜索关键词
platform是string平台代码：`taobao`（淘宝）、`1688`（1688 批发网）
page否string页码，从 `1` 开始，默认 `1`
page_size否string每页条数，默认 `20`
use_platform否string是否使用 1688 平台原生字段返回：`0` 关闭，`1` 开启。仅 1688。详见 1688 接口说明
sort否string排序：`bid2` 价格从高到低；`bid` 价格从低到高；`sale2` 销量从高到低；`sale` 销量从低到高
priceStart否string最低价（含）
priceEnd否string最高价（含）
filter否array筛选条件（仅 1688）。详见 1688 筛选参数

请求示例

{
  "keyword": "handbag",
  "platform": "1688",
  "page": "1",
  "page_size": "20",
  "sort": "sale2",
  "priceStart": "100",
  "priceEnd": "800"
}

响应示例

{
  "ret": 1,
  "msg": "Success",
  "data": {
    "api_type": "taobao",
    "items": {
      "item": [
        {
          "detail_url": "https://item.taobao.com/item.htm?id=877698299628",
          "num_iid": 877698299628,
          "pic_url": "https://img.alicdn.com/imgextra/i3/2635590370/O1CN019Q9JFb1EbVZzd609G_!!4611686018427382498-0-item_pic.jpg",
          "price": "680.00",
          "sales": 0,
          "title_cn": "On My Level 女士小款手袋丨lululemon丨LW9FNDS",
          "title": "On My Level Women's Small Handbag丨Lululemon丨Lw9Fnds",
          "seller_nick": "lululemon官方旗舰店",
          "tags": [],
          "quantity": 200
        }
      ],
      "total_results": 1000
    }
  }
}

响应字段

顶层字段

名称类型说明
retnumber状态码，`1` 表示成功
msgstring状态说明
dataobject响应数据

data.items.item[]

名称类型说明
detail_urlstring商品详情页链接
num_iidinteger平台商品 ID
pic_urlstring主图 URL
pricestring单价
salesinteger累计销量（件）
title_cnstring中文标题
titlestring本地化标题（受 `Language` 请求头影响）
seller_nickstring卖家店铺名（以图搜可能返回追踪 ID；有 `shop_id` 时请用 shop-nick 查询）
tagsarray商品标签
quantityinteger可售库存

分页

名称类型说明
data.items.total_resultsinteger命中商品总数

相关接口