核心内容摘要
凪光闪耀，点亮心中诗意：一场关于美学与情感的深度对话
获取商品类目 IDalibaba.category.get该接口用于拉取 1688 全量类目树获取目标类目的唯一categoryId是调用榜单接口的前提。
接口基础信息请求地址https://gw.open.
com/openapi/param2/2/portals.open/api/getCategory请求方式GET/POST数据格式JSON频率限制单应用 QPS≤10日调用≤5 万次建议本地缓存更新周期≥24 小时
核心请求参数参数名类型是否必填说明methodString是固定值alibaba.category.getapp_keyString是开放平台分配的应用 IDtimestampLong是13 位 Unix 时间戳毫秒级formatString是固定值jsonvString是固定值
0sign_methodString是固定值md5signString是按规则生成的签名
返回核心字段字段名类型说明categoryIdLong类目唯一 ID调用榜单接口的核心参数nameString类目中文名称levelInt类目层级
级1 级为顶级类目parentIdLong父类目 IDisLeafBoolean是否为叶子类目true不可下钻childrenArray子类目列表递归结构
Python 调用示例python运行import requests import hashlib import time # 配置凭证 app_key 你的app_key app_secret 你的app_secret url https://gw.open.
com/openapi/param2/2/portals.open/api/getCategory # 构造基础参数 params { method: alibaba.category.get, app_key: app_key, timestamp: str(int(time.time() *
), format: json, v:
0, sign_method: md5 } # 生成签名 def generate_sign(params, secret): param_str .join([f{k}{v} for k, v in sorted(params.items())]) sign_str secret param_str secret return hashlib.md5(sign_str.encode()).hexdigest().upper() params[sign] generate_sign(params, app_secret) # 发送请求 response requests.get(url, paramsparams) category_data response.json() # 解析类目树递归打印提取目标类目ID def parse_category(categories, level
: for cat in categories: print(f{ *level}[L{cat[level]}] {cat[name]} (ID:{cat[categoryId]})) if children in cat and cat[children]: parse_category(cat[children], level
# 执行解析 if result in category_data and categories in category_data[result]: parse_category(category_data[result][categories])
步骤 2调取类目商品榜单product.topList.query通过步骤 1 获取的categoryId调用该接口获取指定类目下的商品榜单支持多类型、多周期筛选。
接口基础信息请求地址https://gw.open.
com/openapi/param2/1/com.alibaba.product/product.topList.query请求方式GET/POST数据格式JSON数据更新每小时更新企业认证用户响应≤300ms
核心请求参数参数名类型是否必填说明methodString是固定值product.topList.queryapp_keyString是应用 IDtimestampLong是13 位时间戳formatString是jsonvString是
0sign_methodString是md5signString是签名categoryIdLong是步骤 1 获取的类目 ID支持
级rankTypeString是榜单类型complex综合榜、hot热销榜、goodPrice好价榜、anchorHot主播热卖榜、anchorNew主播新兴榜、anchorRecommend主播热推榜、VNHot越南热销榜、VNTrend越南趋势榜pageNoInt否页码默认 1pageSizeInt否每页条数默认 20最大
返回核心字段字段名类型说明offerIdLong商品 IDtitleString商品标题priceString商品价格区间 / 单价saleCountInt销量imageUrlString商品主图 URLcategoryIdLong商品所属类目 IDsellerIdLong卖家 IDevaluateScoreFloat商品评分rankInt榜单排名
Python 调用示例python运行# 沿用步骤1的凭证与签名函数 target_category_id 1031918 # 替换为步骤1获取的目标类目ID rank_type hot # 热销榜可按需替换 # 构造榜单请求参数 rank_params { method: product.topList.query, app_key: app_key, timestamp: str(int(time.time() *
), format: json, v:
0, sign_method: md5, categoryId: target_category_id, rankType: rank_type, pageNo: 1, pageSize: 20 } # 生成签名并请求 rank_params[sign] generate_sign(rank_params, app_secret) rank_url https://gw.open.
com/openapi/param2/1/com.alibaba.product/product.topList.query rank_response requests.get(rank_url, paramsrank_params) rank_data rank_response.json() # 解析榜单数据 if result in rank_data and products in rank_data[result]: products rank_data[result][products] for idx, product in enumerate(products,
: print(f排名{idx} | 商品ID:{product[offerId]} | 标题:{product[title]} | 价格:{product[price]} | 销量:{product[saleCount]})
四、
常见问题与避坑指南权限不足403 错误未申请对应接口权限需在开放平台重新提交权限申请。
签名失败参数未按字母序排序、时间戳过期需 13 位毫秒级、app_secret错误需严格遵循签名规则。
类目 ID 无效传入的categoryId不存在或层级错误需通过类目接口重新核对。
频率超限单应用 QPS 超 10 或日调用超 5 万需增加缓存或申请更高权限。
榜单无数据类目下无对应类型榜单或pageNo超出总页数可更换rankType或调整页码。
进阶应用场景选品分析结合热销榜 好价榜筛选高性价比爆款辅助供应链选品。
竞品监控定时拉取指定类目榜单追踪竞品销量、价格、排名变化。
市场趋势对比日 / 周 / 月榜单识别类目增长趋势预判市场热点。
跨境选品调用VNHot/VNTrend榜单适配东南亚市场需求。