一、业务背景
在竞品调研、跨境选品、类目爆款挖掘、比价统计这类业务中，单纯关键词检索返回的数据杂乱，需要通过筛选条件过滤出符合业务要求的商品。 京东商品搜索接口支持价格区间、自营标识、类目过滤等参数，但不同业务场景下筛选逻辑、参数组合方式不一样，参数搭配不当容易出现结果为空、漏商品、数据不符合预期的问题。本文围绕三个高频筛选维度，梳理参数设计思路、适配方案以及联调踩坑点。
二、核心筛选参数说明
接口名称：JD .item_search（Taobaoapi2014 获取）
类目筛选参数
类目是最基础的过滤条件，用来锁定商品赛道，避免跨类目无关商品混入结果。
核心参数：类目 ID（cid）
业务适配要点
优先使用三级类目 ID，一级、二级类目范围太宽，噪声商品多；
支持单类目筛选，部分场景需要多类目并行检索，采用循环请求，不要一次性拼接多个类目；
类目存在更新、下线、合并的情况，需要维护一份类目映射表，定时同步类目树，防止旧 cid 失效导致无返回；
选品场景：固定类目 + 关键词组合，锁定赛道内商品；竞品监控场景：仅类目检索，用于类目大盘分析。
自营标识筛选参数
区分京东自营、POP 第三方店铺商品，是比价和货源评估的重要条件。
标识字段：isJdSelf（自营标记）
业务适配要点
支持三种模式：只查自营、只查第三方、全部商品；
自营商品价格稳定、售后统一，适合做基准比价；第三方商品适合找差异化货源、低价款；
参数放在请求过滤条件里，而不是拿到结果后再过滤：减少无效数据传输，降低接口返回量；
部分临期、清仓自营商品标识会动态变化，不能只依赖单次结果缓存。
价格区间筛选参数
用于价格带筛选，筛选目标价位段商品，做价格分布统计、利润测算。
核心参数：minPrice、maxPrice
业务适配要点
价格基准：接口筛选使用挂牌售价，不是券后到手价；券后价只能在返回结果之后二次计算，无法通过搜索参数直接过滤；
区间开闭：确认接口是左闭右闭，部分接口不支持 0 元、超大额区间，超出范围会直接报错；
选品场景：分段拉取，比如 0-50、50-100、100-200，统计每个价格区间商品数量；
比价场景：设置价格上限，过滤溢价过高的商品，聚焦有性价比的款式。
三、多参数组合适配方案（按业务场景）
场景 1：跨境选品挖掘
需求：某类目，只看自营，价格区间 50~200 元，按销量排序找爆款 参数组合：关键词 + 三级类目 cid + minPrice=50 + maxPrice=200 + isJdSelf=1 + sort = 销量 适配逻辑：优先稳定性货源，自营品售后链路成熟，适合对外铺货；拿到结果后再提取 SKU、库存、优惠信息做利润评估。
场景 2：第三方货源比价调研
需求：类目下第三方商家，不限价格，按价格升序，找低价货源 参数组合：类目 cid + isJdSelf=0 + sort = 价格升序 适配逻辑：用来寻找差异化供应商，统计第三方价格带分布，监控低价竞品。
场景 3：类目大盘数据分析
需求：整个类目，不分自营 / POP，分多段价格区间批量拉取，统计商品数量分布 适配逻辑：循环价格区间，固定类目，不限制自营标识；多批次请求，汇总数据生成价格分布看板。
场景 4：关键词精准竞品追踪
需求：关键词 + 类目双重锁定，排除无关类目商品，监控价格波动 参数组合：关键词 + cid + 可选价格过滤 适配逻辑：关键词容易泛化，类目作为强约束，减少无关商品。
四、分页、排序配套参数搭配
筛选参数一般和排序、分页一起使用：
sort：销量、价格、上新时间、评价数；
page、pageSize：分页参数； 注意：很多搜索接口总页数有限，不要无限翻页，超过最大页码之后结果会重复或者为空，大盘统计需要换价格分段、类目拆分的方式。
五、数据清洗与兜底校验逻辑
参数层校验：类目 ID 合法性、价格最小值不能大于最大值，参数非法直接拦截，避免无效请求；
返回后二次过滤：
再次校验商品类目是否和目标类目匹配；
二次校验自营标识；
券后价重新计算，和筛选标价区分开存储；
空结果处理：记录日志，区分是没有符合条件商品、参数错误、接口权限问题。
