唯品会关键词搜索接口:突出商品热点

简介: “突出商品热点”需要你来计算:用官方的 weight 推荐值、出单爆款频道以及跨期对比,组合出热点分。

“突出商品热点”需要你来计算:用官方的 weight 推荐值、出单爆款频道以及跨期对比,组合出热点分。

企业微信截图_1792379215509.png

一、接口清单(官方)
服务名:com.vip.adp.api.open.service.UnionGoodsService(1.0.0)

与 UnionGoodsV2Service(2.0.0),网关 https://vop.vip.com/apicenter。

方法 版本 用途 对“热点”的价值
query 1.0.0 关键词查商品(渠道商) 可指定排序,但不支持销量排序
queryWithOauth 1.0.0、2.0.0 关键词查商品(需 oauth) 主力:2.0.0 会额外返回 weight 推荐值和个性化排序
goodsList或goodsListV2WithOauth — 在推商品列表,sourceType=0 时包含超高佣、出单爆款两个频道 官方现成的热货池
getGoodsDetailMarketingWithOauth 2.0.0 单商品详情、精准到手价、活动、未来价 判断“真降价”还是“假促销”
similarRecommendWithOauth、userRecommendWithOauth 2.0.0 相似推荐、猜你喜欢 热门聚合验证

queryWithOauth 2.0.0 的官方说明写得很直白:传入排序字段时,会为每个商品打上 weight(0–100),值越大,推广优先级越高。这是唯品会唯一公开的“热度型”字段,也是你排序的主要依据。
二、必须注意的关键问题:不传 openId 会让“热点”失真
2025 年 5 月 23 日起,联盟搜索接口做了权限升级:

传入正确的 openId → 全量商品池 + 个性化排序 + 营销信息
未传 openId、传 default_open_id、或用搜索批量拉取商品 → 只返回约 10% 的基础商品池,且没有个性化排序,也没有营销信息
这意味着:如果你用默认 openId 批量拉取关键词,算出来的“热榜”只是那一成样本里的排序,这个结论不可靠。要做热点分析,必须先走完 SDK 授权流程,拿到真实的 openId。这是整件事的前提,比选择排序字段重要得多。
三、热点分怎么算
接口不提供销量,因此热度需要由三类信号合成:

官方推荐值weight:直接使用,并归一化到 0–1
排名升幅:每天在同一关键词下抓取一次,计算同一 goodsId 的排名变化;连续 3 天上升的才是真正的热点,单次排名高很可能只是自然排序的抖动
促销力度:折扣率(vipPrice/marketPrice)、券、唯品快抢等活动标识;强促销通常驱动爆发
hot = 0.4 * norm(weight)

+ 0.3 * norm(rank_yesterday - rank_today)
+ 0.2 * norm(discount)
+ 0.1 * norm(跨关键词出现次数)

最后一项容易被忽略,但很好用:同一个 goodsId 在“连衣裙”“显瘦”“夏季”等多个词下都排进前 20,说明它是站内正在被推的爆款,而不是某个词的自然结果。
四、调用骨架
签名规则是 VOP 通用的:把所有参数按 key 升序排列,逐个拼接 key+value,前后各拼上 appSecret,再做 MD5 并转成大写。

import hashlib, time, requests

GATEWAY = "https://vop.vip.com/apicenter"

def sign(params: dict, secret: str) -> str:
raw = "".join(f"{k}{params[k]}" for k in sorted(params))
return hashlib.md5(f"{secret}{raw}{secret}".encode()).hexdigest().upper()

def call(method, biz, app_key, secret, version="2.0.0", token=None):
p = {
"service": "com.vip.adp.api.open.service.UnionGoodsV2Service",
"method": method, "version": version,
"timestamp": str(int(time.time())),
"format": "json", "appKey": app_key,
"request": biz, # JSON 字符串
}
if token: p["accessToken"] = token
p["sign"] = sign(p, secret)
r = requests.post(GATEWAY, data=p, timeout=10)
return r.json()

关键词搜索:keyword / page / pageSize / 排序与 openId 放在 request 内

封装好API demo url=o0b.cn/ibrad

resp = call("queryWithOauth",
'{"keyword":"连衣裙","page":1,"pageSize":50,"openId":"<授权用户openId>"}',
APP_KEY, APP_SECRET, token=ACCESS_TOKEN)

request 里排序字段、价格区间、类目过滤的具体枚举值,请以 http://vop.vip.com 接口页 的在线测试工具为准;各版本的字段名有过调整,从旧文档抄写容易报 1000 参数非法。
频控方面,query* 默认 600 次/30 秒,getByGoodsIds 是 1000 次/30 秒;超限返回 1008,需要做指数退避。

相关文章
|
3月前
|
存储 缓存 搜索推荐
京东券后价≠真实下单价!做比价系统和 ERP 货源对接,这几个价格坑 90% 的人都踩过
本文详解京东原价与券后价的核心差异:原价为官方挂牌价,稳定可用作比价基准;券后价是叠加公开优惠的参考价,易变且不含个性化权益。厘清二者定义、稳定性、用途及计算逻辑,助电商开发规避价格误导、采购偏差等常见陷阱。
612 0
|
4月前
|
数据采集 机器学习/深度学习 监控
跨境选品秘籍:API如何帮你分析全球价格差?
本文探讨如何利用API技术实现全球商品价格差的自动化分析,助力跨境电商精准选品。通过实时抓取多国平台价格数据,结合汇率、税费与库存等维度,识别利润蓝海、优化定价与供应链,并支持动态预警与可视化决策。数据驱动,让选品从“凭经验”迈向“看趋势”。(239字)
|
6月前
|
JSON API 数据格式
国内电商平台商品详情API返回数据Python模型格式
本接口服务支持淘宝、京东、1688三大平台商品详情数据获取,返回标准化Python字典,涵盖标题、价格、库存、图片、SKU、规格、评价等核心字段,含OAuth2.0/签名认证、调用示例及统一解析函数,助力电商数据高效对接。
|
5月前
|
JSON 监控 数据挖掘
电商数据化运营:速卖通API+Python打造竞品监控与选品利器
商品搜索、详情采集、价格监控、SKU 对比、选品分析、自动提醒,适合跨境电商 / 接口开发 / 数据分析使用
|
6月前
|
JSON 缓存 监控
企业级实战:京东商品详情 API 简要说明 + JSON 返回参考
按京东商品 ID(skuId/itemId)获取全量商品详情(基础、价格、库存、SKU、图片、促销、售后、店铺)
|
6月前
|
JSON 供应链 API
企业级实战:1688 图搜接口(item_search_img / 拍立淘) 接入方法
1688图搜API(item_search_img/拍立淘)支持以图搜货,传入图片URL或Base64,返回同款/相似B2B商品(含offerId、价格、起批量等)。含官方入口、完整参数、签名规则、Python调用示例、接入步骤及避坑指南,开箱即用。
|
7月前
|
算法 API 数据处理
闲鱼商品详情API数据解析
本API详解闲鱼商品详情接口(xianyu.item.get),涵盖标准返回结构、关键字段(num_iid、price、condition、seller等)、解析要点及常见坑,含MD5签名实现与错误处理示例,助力快速开发入库。
|
7月前
|
JSON 监控 5G
某宝店铺商品全量接口-item_search_shop
淘宝item_search_shop_pro接口支持按店铺ID全量获取在售商品,含分页、字段筛选与类目过滤;提供完整参数说明、返回字段详解、Python调用示例及风控规范,开箱即用,适用于竞品监控、ERP同步与选品分析。(239字)
|
7月前
|
数据采集 缓存 Java
Python、Java、PHP 三种语言实现爬虫的核心技术对比与示例
本文对比Python、Java、PHP三大语言爬虫技术,涵盖核心工具(如Scrapy/Jsoup/Goutte)、典型代码示例及异步、分布式、缓存等性能优化策略,并给出选型建议与反爬合规实践,助开发者高效构建稳定爬虫系统。
|
8月前
|
JSON 监控 API
京东商品评论内容获取指南
京东商品评论API(jd.item.review)提供结构化评论数据,支持按ID批量获取、好评/差评筛选、图文视频过滤、分页排序及追评、商家回复等维度,JSON格式返回,免申请一键调用,适用于口碑分析与舆情监控。(239字)

热门文章

最新文章