国内电商平台拍立淘图搜 API 均返回 JSON 格式

0 阅读4分钟

一:简述

淘宝、京东、1688的拍立淘按图搜索API主要通过图像识别技术返回与上传图片相似的商品信息,通常以JSON格式返回,包含商品标题、图片、价格、销量等关键字段。以下是淘宝、京东、1688拍立淘按图搜索API的JSON数据返回示例及关键字段说明:

二、核心接口与参数

  1. 基础接口信息

请求方式:POST/GET。

请求地址:c0b.cc/R4rbK2(获取体验…

返回格式:JSON

  1. 关键入参说明

imgBase64:待检索图片Base64编码,单张图片大小≤3M,二选一必填(与imgUrl)。

imgUrl:待检索图片在线地址,公网可正常访问,二选一必填(与imgBase64)。

imageKeywords:辅助检索关键词,可提升匹配精准度,非必填。

filter:结果过滤参数,可筛选商品类型、价格区间等,按需配置。

必填系统参数:_aop_signature(签名)、access_token(授权令牌),保障接口调用安全。

三:各平台数据返回明细

淘宝拍立淘按图搜索API的JSON数据返回示例

json[{"title": "詹姆斯纯棉毛巾底精英袜加厚专业运动中筒吸汗防滑篮球训练袜子男","pic_url": "https://img.alicdn.com/img/bao/uploaded/i4/TB29baudgxlpuFjy0FoXXa.lXXa_!!3003995184.jpg","promotion_price": "22.00","price": "22.00","sales": 700,"num_iid": "544603032967","seller_nick": "Gene Bolt 棉品社","is_tmall": "false","area": "浙江 杭州","detail_url": "//item.taobao.com/item.htm?id=544603032967"},{"title": "时尚女士手提包 简约百搭单肩斜挎包","pic_url": "https://img.example.com/product/123456.jpg","price": "199.00","promotion_price": "159.00","sales": "1234","seller_id": "7890","seller_name": "时尚女包专卖店","detail_url": "https://example.com/product/123456"}]

关键字段说明:

  • title:商品标题或描述。
  • pic_url:商品图片链接。
  • promotion_price:商品优惠价格(如有)。
  • price:商品原价或现价。
  • sales:商品销量或购买人数。
  • num_iid:商品唯一标识。
  • seller_nick:商品卖家昵称。
  • is_tmall:标识商品是否来自天猫商城。
  • area:商品卖家的店铺所在地。
  • detail_url:商品详细页面链接。

1688拍立淘按图搜索API的JSON数据返回示例

json{"code": 200,"message": "success","data": {"search_id": "123e4567-e89b-12d3-a456-426614174000","total_results": 5,"items": [{"item_id": "678901234567","title": "夏季新款纯棉T恤 男士短袖宽松款","price": "¥29.90","min_order": "2件起批","image_url": "https://img.alicdn.com/img/item/678901234567.jpg","shop_name": "XX服饰旗舰店","shop_url": "https://shop.1688.com/shop/xx.html","similarity_score": 0.95},{"item_id": "678901234568","title": "男士纯棉短袖T恤 百搭基础款","price": "¥35.00","min_order": "1件起批","image_url": "https://img.alicdn.com/img/item/678901234568.jpg","shop_name": "YY服饰专营店","shop_url": "https://shop.1688.com/shop/yy.html","similarity_score": 0.92}]}}

关键字段说明:

  • code:状态码,通常为200表示请求成功。
  • message:请求状态描述信息。
  • search_id:请求的唯一标识符。
  • total_results:搜索结果的总商品数量。
  • items:商品列表,包含搜索到的商品信息。
  • item_id:商品ID。
  • similarity_score:相似度得分,表示上传图片与商品的相似程度。

京东拍立淘按图搜索API(假设性示例)

京东的拍立淘按图搜索API可能包含以下字段(具体字段可能因京东API更新而有所变化):

json[{"product_name": "京东自营 纯棉T恤 男士短袖","image_url": "https://img.jd.com/img/item/123456789.jpg","price": "99.00","promotion_price": "79.00","sales_volume": "1000+","product_id": "123456789","shop_name": "京东自营旗舰店","detail_url": "https://item.jd.com/123456789.html"}]

关键字段说明:

  • product_name:商品名称。
  • image_url:商品图片链接。
  • price:商品原价。
  • promotion_price:商品促销价。
  • sales_volume:商品销量。
  • product_id:商品唯一标识。
  • shop_name:店铺名称。
  • detail_url:商品详情页链接。

四、调用与解析要点

  1. 请求方式:均支持 POST/GET,入参为 imgUrl(图片链接)  或 imgBase64(图片 Base64 编码) ,二选一必填。
  2. 返回格式:统一 JSON,便于解析。
  3. 相似度过滤:可通过相似度字段(如 similarity_score>0.8)筛选高匹配商品。
  4. 分页处理:利用 page_no/page_size 实现翻页获取全量结果。
  5. 错误处理:通过 code/success 字段判断调用状态,message 给出异常原因。