当前位置:首页 > 聚焦财报 > 正文内容

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

聚亿千财2025-11-24聚焦财报4463

一、接口概述

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

二、认证方式

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

Authorization: Bearer < access_token >
poYBAGDYdXCAWkKMAAAAK8RNs4s030.png

三、请求参数

参数名 类型 是否必填 说明
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"
}
poYBAGDYdXCAWkKMAAAAK8RNs4s030.png

六、错误代码

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

七、注意事项

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

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

多语言支持:通过language参数切换(支持zh/en/th/vi等)

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

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

​审核编辑 黄宇