Shopee(虾皮)是一个在东南亚和台湾地区非常受欢迎的电子商务平台。其提供了API服务,允许开发者集成其平台功能,如商品搜索、订单管理等。然而,具体的API返回值和参数可能会随着平台的更新而有所变化,因此,我将基于一般的电商API设计理念,为你描述一个可能的Shopee关键词搜索API商品列表返回值的结构。
当你使用Shopee的关键词搜索API时,通常你会发送一个包含搜索关键词的请求,并可能包含其他参数,如排序方式、分页信息等。API的响应将是一个JSON或XML格式的数据包,其中包含搜索结果的列表。
shopee.item_get
公共参数
请求地址: https://api-gw.onebound.cn/shopee/item_get
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
请求参数
请求参数:num_iid=264070136/5637247041&country=.com.my
参数说明:num_iid:商品ID-country:网站后缀(.com.my;.vn;.ph)
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
num_iid | Bigint | 0 | 5637247041 | 宝贝ID |
title | String | 0 | Fashionable plus size womens dress 2020 new spring and summer dress was thin and thin and fat sister dress two-piece suit | 宝贝标题 |
price | Float | 0 | 22.17 | 价格 |
orginal_price | String | 0 | 31.68 | 原价 |
num | Int | 0 | 3836 | 库存 |
detail_url | String | 0 | https://shopee.com.my/product/264070136/5637247041 | 宝贝链接 |
pic_url | String | 0 | https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a | 宝贝图片 |
brand | String | 0 | No Brand | 品牌名称 |
favcount | Int | 0 | 2027 | |
desc | String | 0 | ||
skus | Mix | 0 | {"sku": [{"price": "39", "total_price": null, "orginal_price": "39.00", "properties": "0:0", "properties_name": "0:0:T-shirt+skirt:M 建议【42.5-50KG】", "quantity": "305", "sku_id": "3166598625985"}] | 商品规格信息列表 |
has_discount | String | 0 | true | |
item_size | String | 0 | ||
cid | Int | 0 | 16 | |
currency | String | 0 | MYR | |
size_chart | String | 0 | https://cf.shopee.com.my/file/6105b7c64414c2012908bff679b9321d | |
sales | Int | 0 | 138 | 销量 |
item_imgs | Mix | 0 | [{ "url": "https://cf.shopee.com.my/file/f8bc1116ea922e5ed87a492390b1cc1a"} | 商品图片 |
discount | String | 0 | 30% | |
location | String | 0 | Mainland China | 发货地 |
shop_id | Int | 0 | 151372205 | 店铺ID |
seller_info | Mix | 0 | {"nick": "qzq1274334183.my", "city": "Mainland China", "level": 12, "seller_promotion_refresh_time": "2021-01-19 02:00:00", "zhuy": "https://shopee.com.my/shop/264070136/search", "shop_type": "A"} | 卖家信息 |
prop_imgs | Mix | 0 | [] | 属性图片 |
props_list | Mix | 0 | {20509:9974422: 尺码:36} | 商品属性 |
props_name | String | 0 | 0:0:T-shirt+skirt:M 建议【42.5-50KG】;0:1:T-shirt+skirt:L 建议 【50-57.5kg】; | 商品属性名 |
props | Mix | 0 | [{ "name": "产地","value": "中国" }] | 商品详情 |
current_lang | String | 0 | en | |
currency_code | String | 0 | MYR | |
props_img | Mix | 0 | 1627207:28326": "//img.alicdn.com/imgextra/i2/2844096782/O1CN01VrjpXt1zyCc9DvERE_!!2844096782.jpg | 属性图片 |
shop_item | Mix | 0 | [] | |
relate_items | Mix | 0 | [] | |
tmall | Boolean | 0 | false | 是否天猫 |
error | String | 0 | 错误信息 | |
warning | String | 0 | price_json error;skus miss; | 警告信息 |
url_log | Mix | 0 | [] | |
method | String | 0 | item_tmall:pget_item | |
promo_type | String | 0 |
注意:
- 上面的JSON结构只是一个示例,并不保证与Shopee的实际API返回值完全一致。你应该参考Shopee的官方API文档来获取准确的信息。
- 在实际使用中,你可能需要处理各种错误情况,如无效的搜索关键词、API调用频率限制等。你应该仔细阅读API文档,了解如何处理这些错误情况。
- 对于分页处理,你可能需要根据
pagination
字段中的信息来决定是否继续请求下一页的数据。 - 如果需要更详细的信息或特定字段,你可能需要查看API文档并发送额外的参数来请求这些数据。
- 由于API的更新和变化,建议经常查看官方文档以确保你的代码与最新的API版本兼容。