阿里巴巴按图搜索1688商品(拍立淘) API 返回值说明

阿里巴巴按图搜索1688商品(拍立淘)API 返回值说明

阿里巴巴按图搜索1688商品(拍立淘)API 的返回值通常以 JSON 格式返回,包含搜索结果、商品信息、分页信息等。以下是具体的返回值说明:


1. 请求状态信息
  • code:状态码,通常为 200 表示请求成功,其他值表示错误(如 401 表示未授权,429 表示请求频率过高)。
  • msg:请求状态描述信息,例如 "success" 表示成功,"Unauthorized" 表示未授权。
  • request_id:请求的唯一标识符,用于追踪和调试请求。

2. 搜索结果信息
  • items:商品列表,包含搜索到的商品信息,每个商品为一个对象,包含以下字段:
    • num_iid:商品 ID,1688 平台上商品的唯一标识。
    • title:商品标题,商品的名称或简短描述。
    • pic_url:商品主图 URL,商品的图片地址。
    • price:商品价格,商品的售价。
    • original_price:商品原价(如有)。
    • promotion_price:促销价(如有)。
    • sales:商品销量,商品的累计销量。
    • seller_nick:卖家昵称,提供该商品的店铺名称。
    • area:卖家所在地,商品的发货地或卖家所在地。
    • detail_url:商品详情页 URL,点击后跳转到商品详情页面。
    • similarity_score(可选):相似度得分,表示上传图片与商品的相似程度(通常为 0 到 1 之间的浮点数)。

3. 分页信息
  • page_size:每页返回的商品数量。
  • page_number:当前页码。
  • total_results:搜索结果的总商品数量。
  • total_pages:总页数。

4. 错误信息(如有)
  • error:错误信息,包含错误代码和错误描述。例如:
     

    json复制代码

    {
    "error": {
    "code": 401,
    "message": "Unauthorized: Invalid API Key"
    }
    }

5. 示例返回值

以下是一个示例返回值:

 

json复制代码

{
"code": 200,
"msg": "success",
"request_id": "12345abcde",
"items": [
{
"num_iid": "6789012345678",
"title": "2024新款秋冬加绒卫衣",
"pic_url": "https://img.alicdn.com/imgextra/i1/123456789/O1CN01XXXXXXXXX_XX.jpg",
"price": "89.00",
"original_price": "129.00",
"promotion_price": "79.00",
"sales": 1234,
"seller_nick": "某某旗舰店",
"area": "广东 广州",
"detail_url": "https://detail.1688.com/offer/123456789.html",
"similarity_score": 0.95
},
{
"num_iid": "8765432109876",
"title": "秋冬加绒连帽卫衣女",
"pic_url": "https://img.alicdn.com/imgextra/i2/234567890/O1CN01YYYYYYYYY_XX.jpg",
"price": "99.00",
"original_price": "159.00",
"promotion_price": "89.00",
"sales": 567,
"seller_nick": "某某服饰店",
"area": "浙江 杭州",
"detail_url": "https://detail.1688.com/offer/234567890.html",
"similarity_score": 0.92
}
],
"page_size": 10,
"page_number": 1,
"total_results": 25,
"total_pages": 3
}

6. 注意事项
  • 权限与认证:使用拍立淘 API 需要申请 API Key,并确保 API Key 具有调用权限。可以通过万邦开放平台获取Key账号和调用权限。
  • 请求频率限制:API 调用有频率限制,超出限制可能会返回 429 Too Many Requests 错误。
  • 图片要求:上传的图片需清晰、完整,以提高识别准确率。
  • 数据准确性:搜索结果可能因图片质量、算法匹配度等因素而有所差异。

通过以上返回值说明,开发者可以解析 API 返回的数据,并在应用中展示搜索结果,例如商品列表、商品详情页链接等。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值