当前位置：首页 > news >正文

1688拍立淘接口数据全面解析详细说明（item_search_img）

news 2025/8/25 8:49:13

一、接口概述

1688拍立淘接口是阿里巴巴1688平台提供的基于图像识别的商品搜索服务，允许开发者通过上传商品图片来搜索平台上的同款或相似商品。该接口的主要功能是接收用户上传的图片（或图片的相关信息），并通过1688平台的图像识别和匹配算法，返回与之相似的商品列表信息。

二、接口功能

图片搜索：通过上传图片或提供图片URL，在1688平台上搜索与之相似的商品。
商品信息获取：返回商品的基本信息，如商品标题、价格、销量、图片链接、供应商信息等。
应用场景：广泛应用于电商选品、供应链管理、价格比对等场景。

三、请求方式与参数

（一）请求方式

通常采用HTTP POST请求，因为需要上传图片数据。

（二）请求参数

图片信息：可以是图片的二进制数据，通过file参数上传；或者是图片的URL，使用imageUrl参数。
其他参数：
- appKey：用于验证开发者身份，开发者需要向1688申请该密钥。
- timestamp：请求的时间戳，用于防止重放攻击，保证请求的时效性和唯一性。
- sign：签名，通常是根据请求参数和密钥生成的加密字符串，用于确保请求的安全性和完整性。
- imgid：图片地址（使用淘宝upload_img接口上传图片，返回图片地址）。
- cat：可选，限定搜索类目。
- sort：可选，支持按价格、销量、相关性排序。

四、返回数据解析

接口返回的数据通常为JSON格式，包含以下字段：

items：商品列表，每条商品信息包含：
- num_iid：商品ID。
- title：商品标题。
- price：商品价格。
- pic_url：商品图片链接。
- sales：商品销量。
总记录数：符合搜索条件的相似商品的总数量。
当前页码：当前请求的页码。
每页数量：本次请求设置的每页商品数量。

五、Python请求示例

以下是一个使用Python和requests库调用1688拍立淘接口的示例代码：

import requests
import hashlib
import time
import base64# API接口地址
API_URL = "https://api.1688.com/openapi/router/rest"# 读取图片文件并进行Base64编码
def encode_image(file_path):with open(file_path, "rb") as image_file:return base64.b64encode(image_file.read()).decode("utf-8")# 生成签名
def generate_sign(params, app_secret):param_str = "&".join([f"{k}{v}" for k, v in sorted(params.items())])sign = hashlib.md5(f"{app_secret}{param_str}{app_secret}".encode()).hexdigest().upper()return sign# 调用1688拍立淘接口
def search_similar_items(app_key, app_secret, image_path):timestamp = str(int(time.time() * 1000))image_data = encode_image(image_path)params = {"method": "1688.items.search.img","app_key": app_key,"timestamp": timestamp,"v": "2.0","format": "json","image": image_data}sign = generate_sign(params, app_secret)params["sign"] = signresponse = requests.post(API_URL, data=params)return response.json()# 示例调用
app_key = "your_app_key"
app_secret = "your_app_secret"
image_path = "path_to_your_image.jpg"
result = search_similar_items(app_key, app_secret, image_path)
print(result)