一、业务概述
本文档面向 ERP 货源对接、竞品价格监控、企业采购比价场景，包含搜索列表、单品详情两个核心业务接口说明，用于拉取邦购网服饰商品基础售价、SKU 库存、图片素材、营销活动信息，整体方案采用标准化返回格式，方便业务系统直接解析入库，全程不需要自行处理前端加密与反爬逻辑。
简易技术实现思路
业务调用方携带授权密钥发起接口请求，传入对应的查询参数，服务端完成鉴权、数据拉取、格式清洗之后返回结构化数据。搜索接口支持关键词和类目筛选获取商品 ID 列表，再使用商品 ID 调用详情接口拿到完整 SKU 与库存数据，定时轮询即可实现价格库存的自动监控，整套流程可以无缝对接外贸 ERP、采购比价系统。
二、商品搜索接口说明
业务作用
根据关键词、分类获取商品 SPU 列表，拿到商品唯一编号，作为详情接口的入参。
请求入参
- 授权密钥：对接分配的调用凭证
- 搜索关键词：服饰名称、货号等检索文字
- 页码与每页条数：控制分页批量拉取商品
- 排序规则：销量、价格、上新时间排序
返回核心业务字段
商品标题、商品 ID、品牌名称、分类信息、展示售价、活动标签、商品主图、上架时间。
使用场景
新品监控、类目商品批量采集、采购选品筛选。
三、商品详情接口说明
业务作用
输入商品 ID，返回单品完整结构化全量数据。
请求入参
- 授权密钥
- 邦购网商品唯一 ID
返回核心业务字段
基础信息：商品全称、货号、吊牌价、实时售卖价、优惠活动说明；
SKU 规格：颜色名称、尺码编码、单个 SKU 售价、实时可售库存；
素材资源：主图图集、细节实拍图、详情图文内容；
附加信息：面料参数、销量数据、活动截止时间。
使用场景
ERP 商品上架、定时价格监控、企业采购比价分析。
四、业务对接流程
第一步，获取调用授权密钥；
第二步，调用商品搜索接口，批量获取目标商品 ID 集合；
第三步，循环商品 ID 调用详情接口，保存商品与 SKU 数据；
第四步，配置定时任务，周期性同步价格和库存变化，实现竞品监控。
五、落地注意事项
不建议使用原生网页爬虫做长期商用采集，网站加密策略不定期更新，容易出现接口失效、IP 限制的问题。第三方封装接口已经做好代理池、签名适配、异常重试维护，业务端只需要专注自身业务逻辑开发。所有商用数据使用场景，需要遵守平台协议与数据合规要求。
六、拓展可支持能力
除商品基础数据之外，后续可拓展价格变动推送、库存预警回调接口，当商品降价、断货时主动推送消息给到业务系统，满足自动化竞品运营需求。
