接口标识：goodfish.item_search适用场景：二手货源批量检索、竞品池构建、行情统计、新品发现、价格大盘分析；接口通过关键词、类目、价格区间、成色筛选分页返回商品轻量化列表数据，拿到num_iid后可对接goodfish.item_get商品详情接口补齐完整字段。
一、接口基础信息
接口名称：goodfish.item_search（闲鱼商品列表API，taobaoapi2014前往体验）
请求方式：GET / POST
核心入参：q搜索关键词、page页码、page_size每页条数、price_min最低价格、price_max最高价格
公共参数：key、secret、timestamp、sign签名
说明：列表接口返回轻量化字段；卖家完整信用、商品描述、规格参数不在列表返回，需要调用详情接口获取。
二、顶层响应结构
字段类型说明
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商品发布时间字符串
