淘宝、京东、1688的商品详情API接口均通过JSON格式返回数据,涵盖商品基础信息、价格、库存、图片、规格、评价等核心字段。以下是各平台接口的详细说明及JSON数据示例:
一、淘宝商品详情API接口
核心功能:获取商品标题、价格、库存、图片、SKU、销量、评价等数据。
请求方式:HTTP GET
认证方式:OAuth2.0(需AppKey & AppSecret)
JSON数据示例
json{"item_get_response": {"item": {"num_iid": "1234567890","title": "2024新款男士运动鞋","price": "199.00","pic_url": "https://img.alicdn.com/xxx.jpg","sku": [{"sku_id": "4567890123","properties": "颜色:黑色;尺码:42","quantity": "100","price": "199.00"}],"item_imgs": [{"url": "https://img.alicdn.com/xxx_1.jpg"},{"url": "https://img.alicdn.com/xxx_2.jpg"}],"props_name": "颜色分类:黑色;尺码:42","location": "浙江杭州","post_fee": "0.00","detail_url": "https://item.taobao.com/item.htm?id=1234567890"}}}
关键字段说明
num_iid
:商品唯一IDtitle
:商品标题price
:当前售价sku
:SKU列表(含库存、属性、价格)item_imgs
:商品图片列表props_name
:商品属性名称
二、京东商品详情API接口
核心功能:获取商品名称、价格、库存、规格、评价、促销信息等数据。
请求方式:GET/POST
认证方式:AppKey + 签名校验
频率限制:需申请权限,部分接口有调用限制
JSON数据示例
json{"code": 200,"message": "success","data": {"goods_response": {"sku_id": "100012345678","name": "华为Mate 50 Pro 5G手机","price": 5999.00,"original_price": 6999.00,"image_path": "https://img10.360buyimg.com/n1/s450x450_jfs/t1/123456/78/12345/123456/12345678/1234567890abcdef.jpg","stock_state": 1,"spec_info": {"颜色": ["曜金黑", "冰霜银"],"内存": ["8GB+128GB", "12GB+512GB"]},"evaluation": {"total_reviews": 1000,"positive_rate": "95%"}}}}
关键字段说明
sku_id
:商品唯一IDname
:商品名称price
:当前价格original_price
:原价stock_state
:库存状态(1-有货,0-无货)spec_info
:商品规格(颜色、尺寸等)evaluation
:评价信息(总评价数、好评率)
三、1688商品详情API接口
核心功能:获取商品名称、价格、库存、描述、图片、SKU、供应商信息等数据。
请求方式:HTTP GET/POST
认证方式:AppKey + AppSecret
频率限制:需申请权限,避免触发反爬机制
JSON数据示例
json{"status": "success","result": {"product": {"product_id": "610947572360","title": "韩版仿兔毛围巾秋冬毛毛围巾","price": "2.2","original_price": "25.00","pic_url": "https://img.1688.com/img/xxxxxx.jpg","item_imgs": ["https://img.1688.com/img/xxxxxx1.jpg","https://img.1688.com/img/xxxxxx2.jpg"],"sku_list": [{"sku_id": "123456789","price": "15.00","stock": 100,"attribute_combination": "红色-M"}],"supplier": {"supplier_id": "987654321","supplier_name": "某供应商","contact_person": "张三","contact_phone": "13800138000"}}}}
关键字段说明
product_id
:商品唯一IDtitle
:商品标题price
:当前价格original_price
:原价sku_list
:SKU列表(含库存、属性、价格)supplier
:供应商信息(ID、名称、联系方式)
四、接口调用流程(通用)
注册开发者账号:在各平台开放平台官网注册账号。
创建应用:填写基本信息并提交审核,获取AppKey和AppSecret。
选择接口:根据业务需求选择商品详情接口。
调用接口:使用HTTP请求携带必要参数(如商品ID、签名等)。
处理响应:解析JSON数据,根据业务逻辑处理结果。
五、注意事项
遵守平台规则:避免频繁调用导致账号封禁。
数据安全性:妥善保管API密钥,避免泄露隐私。
异常处理:做好网络异常、数据格式错误等处理逻辑。