接口标识：goodfish.item_search 适用场景：二手货源批量检索、竞品池构建、行情统计、新品发现、价格大盘分析；接口通过关键词、类目、价格区间、成色筛选分页返回商品轻量化列表数据，拿到 num_iid 后可对接 goodfish.item_get 商品详情接口补齐完整字段。
一、接口基础信息
接口名称：goodfish.item_search（闲鱼商品列表 API，taobaoapi2014 前往体验）
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
请求方式：GET / POST
核心入参：q 搜索关键词、page 页码、page_size 每页条数、price_min 最低价格、price_max 最高价格
说明：列表接口返回轻量化字段；卖家完整信用、商品描述、规格参数不在列表返回，需要调用详情接口获取。
二、顶层响应结构
字段类型说明
codeint200 成功；400 参数错误；403 权限；429 限流；500 服务异常
msgstring 返回提示信息，success 为成功
dataobject 分页业务主体
totalint 搜索结果总条数
pageint 当前请求页码
page_sizeint 每页返回条数
itemsarray[object]商品列表数组，无更多数据返回空数组
三、data.items [] 单条列表商品字段
字段类型说明
num_iidstring 商品唯一 ID，核心主键，用于去重、关联详情接口
titlestring 商品标题
pricestring 售卖价格，单位元，保留两位小数
original_pricestring 原价，个人闲置经常为空字符串
pic_urlstring 商品首图 CDN 地址，带防盗链
conditionstring 成色：全新、99 新、95 新、9 成新、8 成新等
locationstring 商品所在地（省市）
statusstring 商品状态：on_sale 在售；sold 已售出；offline 下架
want_countint 想要人数，二手核心热度指标
view_countint 浏览量
detail_urlstring 闲鱼商品 H5 详情链接
category_idstring 类目编码
category_namestring 类目名称
seller_nickstring 卖家昵称
express_feestring 运费金额
published_timestring 商品发布时间字符串
