电商商品详情API接口的示例会因其所属的电商平台而异,因为每个平台都有自己的API设计规范和返回数据结构。不过,我可以提供一个通用的、假设性的电商商品详情API接口示例,以便您理解其基本概念和结构。
假设性电商商品详情API接口示例
请求URL
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# 请求示例 url 默认请求参数已经做URL编码
url = "https://api-gw.od.cn/taobao/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=652874751412&is_promotion=1"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
请求参数(可选,根据API设计而定)
fields
:指定返回的字段,以逗号分隔,用于减少不必要的数据传输。lang
:指定返回内容的语言。
请求头部(通常包括)
Authorization
:包含访问API所需的认证信息,如Bearer Token。Accept
:指定客户端希望接受的内容类型,如application/json
。
响应示例(JSON格式)
{
"item": {
"num_iid": "809486002871",
"title": "棉麻短裤女夏2024新款高腰阔腿裤小个子宽松舒适休闲运动外穿短裤",
"desc_short": "",
"price": 25,
"total_price": "",
"suggestive_price": "",
"orginal_price": 37.5,
"nick": "天天特卖工厂店",
"num": 200,
"detail_url": "https://item.taobao.com/item.htm?id=809486002871",
"pic_url": "//img.alicdn.com/imgextra/i1/3937219703/O1CN01GiSHtF2LY1zfsHgwF_!!3937219703-0-C2M.jpg",
"brand": "无品牌",
"brandId": "",
"rootCatId": "",
"cid": 162201,
"desc": "<div> \n <div> \n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01FWVN681KrtNMg8CYe_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01us9THj1KrtNKKpxC6_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01Cy4lG61KrtNL7PL8G_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01oI0oLR1KrtNMUCmHF_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01QHKwfW1KrtNJdGWPV_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01abuNrE1KrtNJbn5Wg_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01Ujnpzg1KrtNGxOWiS_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01buYYMt1KrtNI8PGp7_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01hX16Ou1KrtNMgBUJt_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01kUuATq1KrtNI8NrWM_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i3/2217637981218/O1CN010zDiYA1KrtNMUAy0N_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01HWud1U1KrtNL7SYiD_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01ELcazi1KrtNNND4np_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01ClWIuL1KrtNMUByPT_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01UNjttP1KrtNLZ4cnw_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01MSAMl41KrtNHnafsl_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01UA3rQr1KrtNNxsecP_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01ve4tzv1KrtNMUDiXG_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01uKlMbR1KrtNMg9Tc4_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01oUWqwd1KrtNMg9PSU_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01ZOpfde1KrtNMUE3KQ_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01ctQIf81KrtNMgCIDg_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01n2b8oj1KrtNHnXeok_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01eAHcXb1KrtNMUBlwd_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01w43Qx71KrtNNxuX3M_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01llcZC41KrtNCQJz4D_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01d2tcp91KrtNLZ4pIj_!!2217637981218-0-scmitem176000.jpg\" align=\"absmiddle\" />\n <img src=\"http://img.alicdn.com/imgextra/i1/2212289861878/O1CN01xy8mYI1PkAmKIuhrA_!!2212289861878-0-scmitem176000.jpg\" /> \n </div> \n </div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.6698b0e2e53af&p=3060574770&k=i_key&t=1721282787\" style=\"display:none\" />",
"item_imgs": [
{
"url": "//img.alicdn.com/imgextra/i1/3937219703/O1CN01GiSHtF2LY1zfsHgwF_!!3937219703-0-C2M.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i1/3937219703/O1CN01ehujvc2LY1zhNJEdq_!!3937219703-0-C2M.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i1/3937219703/O1CN01W9tlX52LY1zdbpHlz_!!3937219703-0-C2M.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i4/3937219703/O1CN01TojheY2LY1zbncfjE_!!3937219703-0-C2M.jpg"
},
{
"url": "//img.alicdn.com/imgextra/i4/3937219703/O1CN013uMdNm2LY1zf7cLTJ_!!3937219703-0-C2M.jpg"
}
],
"item_weight": "",
"post_fee": 0,
"freight": "",
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"video": {
"url": null
},
"sample_id": "",
"props_name": "20518:28314:尺寸:S 建议95斤内;20518:28314:尺寸:S 建议95斤内;20518:28314:尺寸:S 建议95斤内;20518:28315:尺寸:M 建议95-110斤;20518:28315:尺寸:M 建议95-110斤;20518:28315:尺寸:M 建议95-110斤;20518:28316:尺寸:L 建议110-125斤;20518:28316:尺寸:L 建议110-125斤;20518:28316:尺寸:L 建议110-125斤;20518:28317:尺寸:XL 建议125-140斤;20518:28317:尺寸:XL 建议125-140斤;20518:28317:尺寸:XL 建议125-140斤;1627207:4266701:颜色分类:米白色;1627207:28341:颜色分类:黑色;1627207:36963135:颜色分类:雾蓝;1627207:4266701:颜色分类:米白色;1627207:28341:颜色分类:黑色;1627207:36963135:颜色分类:雾蓝;1627207:4266701:颜色分类:米白色;1627207:28341:颜色分类:黑色;1627207:36963135:颜色分类:雾蓝;1627207:4266701:颜色分类:米白色;1627207:28341:颜色分类:黑色;1627207:36963135:颜色分类:雾蓝",
"prop_imgs": {
"prop_img": [
{
"properties": "1627207:4266701",
"url": "http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01ybaiwI1KrtNHltbuC_!!2217637981218-0-scmitem176000.jpg"
},
{
"properties": "1627207:28341",
"url": "http://img.alicdn.com/imgextra/i4/2217637981218/O1CN019JSPVv1KrtNLbn8bR_!!2217637981218-0-scmitem176000.jpg"
},
{
"properties": "1627207:36963135",
"url": "http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01Q1qcgn1KrtNJxneWH_!!2217637981218-0-scmitem176000.jpg"
}
]
},
"props_imgs": {
"prop_img": [
{
"properties": "1627207:4266701",
"url": "http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01ybaiwI1KrtNHltbuC_!!2217637981218-0-scmitem176000.jpg"
},
{
"properties": "1627207:28341",
"url": "http://img.alicdn.com/imgextra/i4/2217637981218/O1CN019JSPVv1KrtNLbn8bR_!!2217637981218-0-scmitem176000.jpg"
},
{
"properties": "1627207:36963135",
"url": "http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01Q1qcgn1KrtNJxneWH_!!2217637981218-0-scmitem176000.jpg"
}
]
},
"property_alias": "",
"props": [
{
"name": "品牌",
"value": "无品牌"
},
{
"name": "尺寸",
"value": "S M L XL"
},
{
"name": "面料",
"value": "棉麻"
},
{
"name": "风格",
"value": "通勤"
},
{
"name": "通勤",
"value": "韩版"
},
{
"name": "女裤腰高",
"value": "高腰"
},
{
"name": "产地",
"value": "中国"
},
{
"name": "流行元素",
"value": "简约"
},
{
"name": "颜色分类",
"value": "米白色 黑色 雾蓝"
},
{
"name": "货号",
"value": "999"
},
{
"name": "年份季节",
"value": "2024年夏季"
},
{
"name": "厚薄",
"value": "常规"
},
{
"name": "裤长",
"value": "短裤"
},
{
"name": "女裤裤型",
"value": "阔腿裤"
},
{
"name": "材质成分",
"value": "其他100%"
}
],
"total_sold": "-1",
"skus": {
"sku": [
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28314;1627207:4266701",
"properties_name": "20518:28314:尺寸:S 建议95斤内;1627207:4266701:颜色分类:米白色",
"quantity": 200,
"sku_id": "5500723041854"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28314;1627207:28341",
"properties_name": "20518:28314:尺寸:S 建议95斤内;1627207:28341:颜色分类:黑色",
"quantity": 200,
"sku_id": "5500723041847"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28314;1627207:36963135",
"properties_name": "20518:28314:尺寸:S 建议95斤内;1627207:36963135:颜色分类:雾蓝",
"quantity": 200,
"sku_id": "5500723041851"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28315;1627207:4266701",
"properties_name": "20518:28315:尺寸:M 建议95-110斤;1627207:4266701:颜色分类:米白色",
"quantity": 200,
"sku_id": "5500723041852"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28315;1627207:28341",
"properties_name": "20518:28315:尺寸:M 建议95-110斤;1627207:28341:颜色分类:黑色",
"quantity": 200,
"sku_id": "5500723041844"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28315;1627207:36963135",
"properties_name": "20518:28315:尺寸:M 建议95-110斤;1627207:36963135:颜色分类:雾蓝",
"quantity": 200,
"sku_id": "5500723041849"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28316;1627207:4266701",
"properties_name": "20518:28316:尺寸:L 建议110-125斤;1627207:4266701:颜色分类:米白色",
"quantity": 200,
"sku_id": "5497237692131"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28316;1627207:28341",
"properties_name": "20518:28316:尺寸:L 建议110-125斤;1627207:28341:颜色分类:黑色",
"quantity": 200,
"sku_id": "5500723041845"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28316;1627207:36963135",
"properties_name": "20518:28316:尺寸:L 建议110-125斤;1627207:36963135:颜色分类:雾蓝",
"quantity": 200,
"sku_id": "5500723041850"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28317;1627207:4266701",
"properties_name": "20518:28317:尺寸:XL 建议125-140斤;1627207:4266701:颜色分类:米白色",
"quantity": 200,
"sku_id": "5500723041846"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28317;1627207:28341",
"properties_name": "20518:28317:尺寸:XL 建议125-140斤;1627207:28341:颜色分类:黑色",
"quantity": 200,
"sku_id": "5500723041848"
},
{
"price": 25,
"total_price": 0,
"orginal_price": 37.5,
"properties": "20518:28317;1627207:36963135",
"properties_name": "20518:28317:尺寸:XL 建议125-140斤;1627207:36963135:颜色分类:雾蓝",
"quantity": 200,
"sku_id": "5500723041853"
}
]
},
"seller_id": "3937219703",
"sales": 0,
"shop_id": "465965982",
"props_list": {
"20518:28314": "尺寸:S 建议95斤内",
"20518:28315": "尺寸:M 建议95-110斤",
"20518:28316": "尺寸:L 建议110-125斤",
"20518:28317": "尺寸:XL 建议125-140斤",
"1627207:4266701": "颜色分类:米白色",
"1627207:28341": "颜色分类:黑色",
"1627207:36963135": "颜色分类:雾蓝"
},
"seller_info": {
"nick": "天天特卖工厂店",
"item_score": 4.67574,
"score_p": 4.75174,
"delivery_score": 4.77609,
"shop_type": "",
"user_num_id": "3937219703",
"sid": null,
"title": "",
"zhuy": "https://shop465965982.taobao.com",
"cert": null,
"open_time": "",
"credit_score": null,
"shop_name": "天天特卖工厂店"
},
"tmall": true,
"error": "",
"location": null,
"data_from": "ha",
"has_discount": "true",
"is_promotion": "true",
"promo_type": null,
"props_img": {
"1627207:4266701": "http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01ybaiwI1KrtNHltbuC_!!2217637981218-0-scmitem176000.jpg",
"1627207:28341": "http://img.alicdn.com/imgextra/i4/2217637981218/O1CN019JSPVv1KrtNLbn8bR_!!2217637981218-0-scmitem176000.jpg",
"1627207:36963135": "http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01Q1qcgn1KrtNJxneWH_!!2217637981218-0-scmitem176000.jpg"
},
"format_check": "ok",
"desc_img": [
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01FWVN681KrtNMg8CYe_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01us9THj1KrtNKKpxC6_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01Cy4lG61KrtNL7PL8G_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01oI0oLR1KrtNMUCmHF_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01QHKwfW1KrtNJdGWPV_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01abuNrE1KrtNJbn5Wg_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01Ujnpzg1KrtNGxOWiS_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01buYYMt1KrtNI8PGp7_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01hX16Ou1KrtNMgBUJt_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01kUuATq1KrtNI8NrWM_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i3/2217637981218/O1CN010zDiYA1KrtNMUAy0N_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01HWud1U1KrtNL7SYiD_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01ELcazi1KrtNNND4np_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01ClWIuL1KrtNMUByPT_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01UNjttP1KrtNLZ4cnw_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01MSAMl41KrtNHnafsl_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01UA3rQr1KrtNNxsecP_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i1/2217637981218/O1CN01ve4tzv1KrtNMUDiXG_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01uKlMbR1KrtNMg9Tc4_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01oUWqwd1KrtNMg9PSU_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01ZOpfde1KrtNMUE3KQ_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01ctQIf81KrtNMgCIDg_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01n2b8oj1KrtNHnXeok_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i4/2217637981218/O1CN01eAHcXb1KrtNMUBlwd_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01w43Qx71KrtNNxuX3M_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i2/2217637981218/O1CN01llcZC41KrtNCQJz4D_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i3/2217637981218/O1CN01d2tcp91KrtNLZ4pIj_!!2217637981218-0-scmitem176000.jpg",
"http://img.alicdn.com/imgextra/i1/2212289861878/O1CN01xy8mYI1PkAmKIuhrA_!!2212289861878-0-scmitem176000.jpg"
],
"shop_item": [],
"relate_items": []
},
"error": "",
"secache": "af6211ce6505aa424e394967d1ee940a",
"secache_time": 1721282787,
"secache_date": "2024-07-18 14:06:27",
注意事项
- 实际API接口的地址、请求方式(GET、POST等)、请求参数和响应结构可能会根据电商平台的实际API文档有所不同。
- 在实际开发中,您应该仔细阅读目标电商平台的API文档,了解如何正确调用API、如何传递参数、如何处理响应以及如何处理错误和异常情况。
- 认证和授权是访问电商平台API的重要步骤,确保您已经获得了必要的认证信息(如API密钥、OAuth令牌等),并在请求中正确地包含了这些信息。
- 考虑到性能和带宽问题,有些电商平台可能允许您通过请求参数指定需要返回的字段,以减少不必要的数据传输。在实际使用中,您应该根据需要合理选择需要返回的字段。