海外电商平台虾皮商品详情API接口技术指南

​

一、接口概述

虾皮商品详情API接口用于获取指定商品的详细信息，包括标题、价格、规格、描述、图片等核心数据。该接口采用RESTful风格，支持GET请求，返回JSON格式数据。

二、认证方式

调用接口需使用OAuth 2.0认证，需在请求头携带访问令牌：

Authorization: Bearer < access_token >

三、请求参数

参数名	类型	是否必填	说明
item_id	string	是	商品唯一标识
language	string	否	返回语言（默认en）
version	int	否	API版本（默认1）

四、请求示例

import requests

url = "https://api.shopee.com/v2/items/get_detail"
params = {
    "item_id": "1234567890",
    "language": "zh"
}
headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
}

response = requests.get(url, params=params, headers=headers)
data = response.json()

五、响应结构

{
  "code": 0,
  "data": {
    "item_id": "1234567890",
    "title": "无线蓝牙耳机",
    "price": 29.99,
    "currency": "USD",
    "specs": [
      {"key": "颜色", "value": "黑色"},
      {"key": "续航", "value": "20小时"}
    ],
    "images": [
      "https://img.shopee.com/xxx1.jpg",
      "https://img.shopee.com/xxx2.jpg"
    ],
    "description": "高保真音质...",
    "stock": 150,
    "rating": 4.8
  },
  "message": "success"
}

六、错误代码

代码	说明
0	请求成功
101	认证失败
201	商品不存在
301	参数错误
500	服务器内部错误

七、注意事项

每日调用限制：1000次/账号

数据缓存建议：商品数据更新周期为15分钟

多语言支持：通过language参数切换（支持zh/en/th/vi等）

特殊字符处理：需对URL进行编码处理

提示：实际调用前请查阅最新版官方文档，接口可能有版本更新。建议使用官方提供的SDK简化开发流程。

​审核编辑 黄宇