蘑菇街的 item_get 接口是用于获取蘑菇街平台商品详情的核心接口，能够获取商品的完整信息，包括基础属性、价格、库存、规格、促销活动、店铺信息等。该接口对于电商数据分析、竞品监控、多平台商品对比等场景具有重要价值，尤其适用于时尚服饰、美妆护肤等蘑菇街优势品类的分析。
一、接口核心特性分析
1. 接口功能与定位
2. 认证机制
3. 核心参数与响应结构
请求参数
响应核心字段
二、Python 脚本实现
import requests
import time
import json
import logging
import hashlib
from typing import Dict, Optional, List
from requests.exceptions import RequestException
# 配置日志
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s - %(levelname)s - %(message)s"
)
class MogujieItemAPI:
def __init__(self, appkey: str, appsecret: str):
"""
初始化蘑菇街API客户端
:param appkey: 蘑菇街开放平台appkey
:param appsecret: 蘑菇街开放平台appsecret
"""
self.appkey = appkey
self.appsecret = appsecret
self.base_url = "https://api.mogujie.com"
self.access_token = None
self.token_expires_at = 0 # token过期时间戳
self.session = requests.Session()
# 设置默认请求头
self.session.headers.update({
"Content-Type": "application/json",
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36"
})
def _get_access_token(self) -> Optional[str]:
"""获取访问令牌"""
# 检查token是否有效
if self.access_token and self.token_expires_at > time.time() + 60:
return self.access_token
logging.info("获取新的access_token")
url = f"{self.base_url}/oauth/token"
params = {
"grant_type": "client_credentials",
"client_id": self.appkey,
"client_secret": self.appsecret
}
try:
response = self.session.post(url, json=params, timeout=10)
response.raise_for_status()
result = response.json()
if "access_token" in result:
self.access_token = result["access_token"]
self.token_expires_at = time.time() + result.get("expires_in", 7200) # 默认为2小时
return self.access_token
else:
logging.error(f"获取access_token失败: {result.get('error_description', '未知错误')}")
return None
except RequestException as e:
logging.error(f"获取access_token请求异常: {str(e)}")
return None
def get_item_details(self, item_id: str, fields: Optional[str] = None) -> Optional[Dict]:
"""
获取商品详情
:param item_id: 商品ID
:param fields: 需要返回的字段，多个用逗号分隔
:return: 商品详情数据
"""
# 获取有效的access_token
if not self._get_access_token():
return None
url = f"{self.base_url}/item/get"
# 构建请求参数
params = {
"item_id": item_id,
"access_token": self.access_token
}
# 添加需要返回的字段
if fields:
params["fields"] = fields
try:
response = self.session.get(url, params=params, timeout=15)
response.raise_for_status()
result = response.json()
# 检查响应状态
if result.get("code") == 0:
# 格式化商品数据
return self._format_item_data(result.get("data", {}))
else:
logging.error(f"获取商品详情失败: {result.get('message', '未知错误')} (错误码: {result.get('code')})")
return None
except RequestException as e:
logging.error(f"获取商品详情请求异常: {str(e)}")
return None
except json.JSONDecodeError:
logging.error(f"商品详情响应解析失败: {response.text[:200]}...")
return None
def _format_item_data(self, item_data: Dict) -> Dict:
"""格式化商品数据"""
# 基础信息
basic_info = {
"item_id": item_data.get("item_id"),
"title": item_data.get("title"),
"subtitle": item_data.get("subtitle"),
"brand": {
"brand_id": item_data.get("brand_id"),
"brand_name": item_data.get("brand_name")
},
"main_images": item_data.get("main_images", []),
"detail_images": item_data.get("detail_images", []),
"detail_url": item_data.get("detail_url"),
"category": {
"cat_id": item_data.get("cat_id"),
"cat_name": item_data.get("cat_name"),
"parent_cat_id": item_data.get("parent_cat_id"),
"parent_cat_name": item_data.get("parent_cat_name")
},
"tags": item_data.get("tags", []), # 商品标签，如"新品"、"热卖"等
"desc": item_data.get("desc") # 商品描述
}
# 价格信息
price_info = {
"original_price": float(item_data.get("original_price", 0)),
"current_price": float(item_data.get("current_price", 0)),
"discount": float(item_data.get("discount", 0)),
"member_price": float(item_data.get("member_price", 0)) if item_data.get("has_member_price") else None,
"has_member_price": item_data.get("has_member_price", False),
"coupon_info": item_data.get("coupon_info", {}) # 优惠券信息
}
# 库存信息
stock_info = {
"total_stock": int(item_data.get("total_stock", 0)),
"sold_count": int(item_data.get("sold_count", 0)), # 已售数量
"is_in_stock": item_data.get("is_in_stock", False),
"limit_buy": item_data.get("limit_buy", 0) # 限购数量
}
# 规格信息
sku_info = {
"has_sku": item_data.get("has_sku", False),
"sku_list": [],
"specs": item_data.get("specs", {}) # 规格定义，如颜色、尺寸等
}
# 处理规格数据
if sku_info["has_sku"] and "skus" in item_data:
for sku in item_data["skus"]:
sku_info["sku_list"].append({
"sku_id": sku.get("sku_id"),
"spec_text": sku.get("spec_text"), # 规格组合文本，如"红色,XL"
"spec_values": sku.get("spec_values", []), # 规格值组合
"price": float(sku.get("price", 0)),
"original_price": float(sku.get("original_price", 0)),
"stock": int(sku.get("stock", 0)),
"image": sku.get("image")
})
# 促销信息
promotion_info = {
"promotions": item_data.get("promotions", []), # 促销活动列表
"start_time": item_data.get("promotion_start_time"),
"end_time": item_data.get("promotion_end_time"),
"is_promotion": item_data.get("is_promotion", False)
}
# 店铺信息
shop_info = {
"shop_id": item_data.get("shop_id"),
"shop_name": item_data.get("shop_name"),
"shop_logo": item_data.get("shop_logo"),
"shop_type": item_data.get("shop_type"), # 店铺类型，如"旗舰店"、"专营店"
"score": {
"overall": float(item_data.get("shop_score", {}).get("overall", 0)),
"description": float(item_data.get("shop_score", {}).get("description", 0)),
"service": float(item_data.get("shop_score", {}).get("service", 0)),
"shipping": float(item_data.get("shop_score", {}).get("shipping", 0))
},
"fans_count": int(item_data.get("fans_count", 0)), # 店铺粉丝数
"good_rate": float(item_data.get("good_rate", 0)) # 好评率
}
# 社交元素信息（蘑菇街特色）
social_info = {
"fav_count": int(item_data.get("fav_count", 0)), # 收藏数
"like_count": int(item_data.get("like_count", 0)), # 点赞数
"comment_count": int(item_data.get("comment_count", 0)), # 评论数
"buyer_show": item_data.get("buyer_show", []), # 买家秀
"recommender": item_data.get("recommender", {}) # 推荐达人信息
}
# 物流信息
logistics_info = {
"freight": float(item_data.get("freight", 0)),
"freight_free": item_data.get("freight_free", False), # 是否包邮
"freight_free_amount": float(item_data.get("freight_free_amount", 0)), # 包邮门槛
"delivery_time": item_data.get("delivery_time"), # 发货时间
"shipping_address": item_data.get("shipping_address") # 发货地
}
return {
"basic_info": basic_info,
"price_info": price_info,
"stock_info": stock_info,
"sku_info": sku_info,
"promotion_info": promotion_info,
"shop_info": shop_info,
"social_info": social_info,
"logistics_info": logistics_info,
"raw_data": item_data # 保留原始数据
}
# 示例调用
if __name__ == "__main__":
# 替换为实际的appkey和appsecret（从蘑菇街开放平台获取）
APPKEY = "your_appkey"
APPSECRET = "your_appsecret"
# 替换为目标商品ID
ITEM_ID = "12345678"
# 初始化API客户端
api = MogujieItemAPI(APPKEY, APPSECRET)
# 获取商品详情（可以指定需要返回的字段，如："item_id,title,current_price,stock"）
item_details = api.get_item_details(ITEM_ID)
if item_details:
print(f"=== 商品详情 ===")
print(f"商品ID: {item_details['basic_info']['item_id']}")
print(f"商品标题: {item_details['basic_info']['title']}")
print(f"品牌: {item_details['basic_info']['brand']['brand_name']}")
print(f"原价: {item_details['price_info']['original_price']}元")
print(f"现价: {item_details['price_info']['current_price']}元")
if item_details['price_info']['discount'] > 0:
print(f"折扣: {item_details['price_info']['discount']}折")
if item_details['price_info']['has_member_price']:
print(f"会员价: {item_details['price_info']['member_price']}元")
print(f"库存: {item_details['stock_info']['total_stock']}")
print(f"已售: {item_details['stock_info']['sold_count']}件")
print(f"店铺: {item_details['shop_info']['shop_name']}")
print(f"店铺评分: {item_details['shop_info']['score']['overall']}分")
print(f"收藏数: {item_details['social_info']['fav_count']}")
print(f"评论数: {item_details['social_info']['comment_count']}")
if item_details['promotion_info']['is_promotion']:
print(f"\n促销活动:")
for promo in item_details['promotion_info']['promotions'][:2]:
print(f"- {promo.get('name')}")
if item_details['sku_info']['has_sku']:
print(f"\n规格数量: {len(item_details['sku_info']['sku_list'])}")
for i, sku in enumerate(item_details['sku_info']['sku_list'][:3], 1):
print(f" 规格{i}: {sku['spec_text']} - {sku['price']}元 - 库存{sku['stock']}")