一文吃透闲鱼 API：关键词搜品 + 单品详情 ，搭建二手商品监控平台

摘要

很多开发者想要搭建闲鱼二手商品监控、二手选品系统，会优先寻找「关键词搜品、单品详情、整店抓取」三类 能力。但很多人踩坑：混淆闲鱼 ISV 官方接口和逆向抓包接口。

整店商品列表（整店抓取：拉取本托管店铺全部商品 ID）

单品详情查询（alibaba.idle.isv.item.query 根据 item_id 获取单品详情）

店铺内关键词过滤（在自己店铺商品集合内做本地关键词筛选）

本文完整拆解闲鱼 ISV 三大合法能力，对比逆向方案，给出接口参数、JSON 样例、系统架构 、开发流程、线上踩坑，帮助开发者正确评估二手监控平台可行性。

一、三大 ISV 能力接口基础信息

三大接口基础信息

公共请求基础信息

【整店商品列表】业务入参   

整店列表 JSON 样例

{
    "alibaba_idle_isv_item_list_query_response": {
        "request_id": "req‑20260924141000123456",
        "total":42,
        "page_no":1,
        "page_size":20,
        "item_list":[
            {
                "item_id":"3100123456789",
                "title":"95新无线蓝牙耳机降噪长续航",
                "status":"on_sale",
                "quality":"95新",
                "price":"189.00",
                "is_fish_treasure":true,
                "created_time":"2026‑07‑10 15:30:22"
            },
            {
                "item_id":"3100123456790",
                "title":"机械键盘青轴游戏办公键盘",
                "status":"on_sale",
                "quality":"9成新",
                "price":"129.00",
                "is_fish_treasure":false,
                "created_time":"2026‑07‑12 10:20:11"
            }
        ]
    }
}

【单品详情】业务入参

单品详情 JSON 样例

{
    "alibaba_idle_isv_item_query_response": {
        "request_id": "req‑20260924141200345678",
        "item_info": {
            "item_id": "3100123456789",
            "title": "95新 无线蓝牙耳机 降噪长续航",
            "sub_title": "个人闲置，几乎无磨损",
            "status": "on_sale",
            "quality": "95新",
            "price": "189.00",
            "original_price": "399.00",
            "is_fish_treasure": true,
            "is_personal": true,
            "main_images": [
                "https://img1.taobao.org/imgextra/i2/O1CN01xxx1.jpg",
                "https://img1.taobao.org/imgextra/i2/O1CN01xxx2.jpg"
            ],
            "desc": "<p>自用蓝牙耳机，95新，功能全部正常，配件齐全。</p>",
            "delivery_from": "广东深圳",
            "freight_type": "buyer_pay",
            "freight_fee": 12.00,
            "browse_count": 1240,
            "want_count": 86,
            "created_time": "2026‑07‑10 15:30:22",
            "modified_time": "2026‑08‑02 09:10:11"
        }
    }
}

二、核心返回字段释义

三、常见错误码说明

四、业务拓展联动其他 ISV 接口

闲鱼 ISV 订单接口：读取托管店铺订单，完成 ERP 进销存闭环；

商品变更消息回调：订阅商品上下架、价格变更推送，减少轮询调用；

AI 能力：标题、描述改写，生成二手商品上架文案。