item_search_shop-获得店铺的所有商品
shopee.item_search_shop
公共参数
请求地址: https://api-gw-4.onebound.cn/shopee/item_search_shop
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
key | String | 是 | 调用key(必须以GET方式拼接在URL中) |
secret | String | 是 | 调用密钥 |
api_name | String | 是 | API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等] |
cache | String | 否 | [yes,no]默认yes,将调用缓存的数据,速度比较快 |
result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读 |
lang | String | 否 | [cn,en,ru]翻译语言,默认cn简体中文 |
version | String | 否 | API版本 |
请求参数
请求参数:shop_id=239487269&country=.com.my&page=1
参数说明:shop_id:店铺ID-country:网站后缀(.com.my;.vn;.ph)
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iid | Bigint | 0 | 5631858520 | 商品iD |
pic_url | String | 0 | https://cf.shopee.com.my/file/05db4b1f181a50e1ae54e803955f04cd | 图片地址 |
title | String | 0 | 🌈Korean House🌸Spring Autumn Korean Long-sleeve baju perempuan T-shirt Lengan Panjang Women Clothes Blouse Loose Clothing Tops Murah | 店铺标题 |
orginal_price | Float | 0 | 27.8 | 原价 |
price | Float | 0 | 13.9 | 价格 |
sales | Int | 0 | 31965 | 销量 |
detail_url | String | 0 | https://shopee.com.my/product/239487269/5631858520 | 主页 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw-4.cn/shopee/item_search_shop/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&shop_id=239487269&country=.com.my&page=1"
响应示例
异常示例
相关资料
错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
---|---|---|---|
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
API 工具
在使用虾皮(Shopee)的API获取店铺的所有商品时,你将调用与商品相关的API端点。这些API端点通常会返回商品的详细信息列表,包括每个商品的基本属性、图片、价格、库存等。
由于Shopee的API可能会根据地区、市场和时间有所更新,我无法提供一个精确和固定的返回值说明。但是,我可以为你提供一个常见的商品列表API返回值的示例,这将帮助你理解可能返回的字段和数据结构。
```json
{
"items": [
{
"item_id": 123456789, // 商品ID
"item_name": "示例商品", // 商品名称
"current_price": "10.00", // 当前售价
"original_price": "20.00", // 原价
"currency": "MYR", // 货币单位
"stock_quantity": 100, // 库存数量
"sold_quantity": 50, // 已售数量
"images": [ // 商品图片列表
"https://example.com/image1.jpg",
"https://example.com/image2.jpg"
],
"item_description": "这是一个示例商品描述。", // 商品描述
"shipping_fee": "0.00", // 运费
"shipping_type": "NORMAL", // 发货类型(例如:NORMAL为普通发货,EXPEDITED为加急发货)
"shop_id": 12345, // 所属店铺ID
// ... 其他可能的字段,如商品属性、分类、评分等
},
{
// 第二个商品的详细信息
},
// ... 更多商品
],
"total_count": 20, // 总商品数量(可能是分页后的结果数量)
"has_more": true // 是否有更多商品(用于分页)
}
```
请注意,这只是一个示例,实际的返回值可能会根据API的版本和具体实现有所不同。为了获取最准确的信息,你应该查阅Shopee的官方API文档,该文档会提供最新的字段列表、数据类型和API使用方法。
此外,当你使用API时,还需要注意以下几点:
1. 分页处理:如果店铺的商品数量很多,API通常会支持分页返回结果。你需要查看文档以了解如何传递分页参数(如`limit`和`offset`)来获取所有商品。
2. 错误处理:检查API返回值中是否包含错误代码或消息,以便在出现问题时能够适当地处理。
3. 频率限制:Shopee的API通常有调用频率限制,确保你的请求遵守这些限制,以免被限制访问。
4. 数据更新:商品信息可能会随时间变化,包括价格、库存等,确保你的应用能够处理这些动态变化。
最后,请记住,使用API可能需要注册开发者账号,并获取相应的API密钥或访问令牌。在调用API之前,确保你已经完成了所有必要的注册和认证步骤。