速卖通图片搜索接口2025最新调用指南（附Python代码实例）

🔍 接口概述

速卖通Aliexpress Image Search API 支持通过图片哈希值/URL检索同款商品，2025年版本新增==‌多图混合搜索‌==和==‌版权过滤参数‌==，响应延迟优化至300ms以内（较2023年降低40%）

点击获取key和secret

🛠️ 前置条件

1. 开通速卖通开放平台账号（需企业认证）
2. 创建应用获取凭证：

   App Key = ALI_2025_XXXXXX
   App Secret = ==‌****====****‌==***
   

申请「图片搜索」API权限（注意：个人开发者账号已不可用） 📌 接口参数详解（v3.1版） python Copy Code import requests import hashlib

def aliexpress_image_search(image_path): # 新版OAuth2.0认证 auth_url = "auth.aliexpress.com/oauth2/toke…" auth_data = { "grant_type": "client_credentials", "client_id": "ALI_2025_XXXXXX", "client_secret": "==‌****====****‌==***" } token = requests.post(auth_url, data=auth_data).json()['access_token']

# 生成图片特征指纹（2025新增SHA-3算法）
with open(image_path, "rb") as f:
    image_hash = hashlib.sha3_256(f.read()).hexdigest()

# 构造请求头
headers = {
    "Authorization": f"Bearer {token}",
    "X-Copyright-Check": "strict"  # 新增版权过滤参数
}

# 请求端点
api_url = "https://api.aliexpress.com/image-search/v3.1/items"
params = {
    "image_hash": image_hash,
    "max_results": 50,
    "price_range": "10-100",       # 价格过滤
    "ship_to": "US"                # 区域限定
}

response = requests.get(api_url, headers=headers, params=params)
return response.json()

调用示例

result = aliexpress_image_search("product.jpg") print(result)

💡 高频问题解决方案

‌Q：返回403 CopyrightViolation错误‌ ⇒ 启用X-Copyright-Check: "loose"模式或更换原创图片

‌Q：图片尺寸过大（>5MB）‌ ⇒ 使用压缩预处理：

python Copy Code from PIL import Image def compress_image(input_path, output_path, quality=85): img = Image.open(input_path) img.save(output_path, optimize=True, quality=quality)

‌Q：多图混合搜索实现‌ ⇒ 拼接多个image_hash值：

python Copy Code params["image_hash"] = "hash1|hash2|hash3" # 竖线分隔符

⚠️ 重要限制 免费版QPS：2次/秒（付费套餐可达50次/秒） 图片格式限制：JPG/PNG/WEBP（不再支持GIF） 结果排序算法：相关性(60%) + 销量(30%) + 物流评分(10%)

附：官方文档更新日志（2025.02.15生效）：

弃用v2.x旧版接口 新增AI生成图片检测机制 响应字段新增similarity_score相似度评分 text Copy Code