闲鱼商品详情 API 接口解析(附 JSON 样例)

简介: 本文详解闲鱼TOP平台`goodfish.item_get`接口:涵盖鉴权(需店铺托管OAuth授权)、参数规范、签名算法、字段释义及实战避坑经验,强调仅限查询已托管商品,不支持跨店/陌生人商品。

摘要
在二手 ERP、鱼小铺店铺管理、二手货源监控、商品素材归档等项目开发 中,很多开发者希望获取闲鱼商品结构化详情数据。这里有一个核心前提:闲鱼 TOP 开放平台没有对外提供可以随意读取全网任意陌生人商品的通用详情接口。

本文完整解析官方 goodfish.item_get 接口,包含接口基础信息、请求参数、返回 JSON 样例、字段释义、错误码、开发流程和线上踩坑经验。

一、接口基础信息
1.公共请求参数
参数名 类型 必填 说明
method string 是 固定值 alibaba.idle.isv.item.query
app_key string 是 TOP 开放平台分配的 ISV 应用密钥
timestamp string 是 GMT+8 时区,格式yyyy‑MM‑dd HH:mm:ss;时间误差不可超过 10 分钟
v string 是 协议版本,固定2.0
sign_method string 是 签名算法,hmac‑sha256 /md5
sign string 是 加密生成的签名字符串
session string 是 店铺托管授权 OAuth session,必填,无托管授权调用直接报错

2.接口基础信息
项目 说明
接口 Method goodfish.item_get(前往Taobaoapi2014体验)
请求方式 GET / POST,生产环境推荐 POST
鉴权方式 app_key + app_secret + OAuth session 授权;必须完成店铺托管授权
签名算法 md5 /hmac‑sha256;参数按 ASCII 字典序升序生成 sign 签名
协议版本 v2.0
返回格式 JSON / XML,项目开发优先 JSON
硬性边界 只能查询该应用托管的闲鱼 / 鱼小铺商品;外部陌生人商品直接返回查询失败;需要闲管家 ISV 服务商资质。

3.业务入参
参数名 类型 必填 说明
item_id long 是 闲鱼商品 ID,来自托管店铺商品列表接口alibaba.idle.isv.item.list.query返回
need_sku boolean 否 是否返回 SKU 信息,不需要传 false,减少接口响应耗时

相关文章
|
2月前
|
JSON 监控 API
一文吃透闲鱼 API:关键词搜品 + 单品详情 ,搭建二手商品监控平台
本文详解闲鱼ISV官方三大合法接口:整店商品拉取、单品详情查询、店铺内关键词筛选,对比逆向抓包风险,提供参数规范、JSON示例、架构设计及避坑指南,助开发者合规构建二手监控与选品系统。(238字)
|
JSON BI API
全网最全面介绍闲鱼API接口指南
闲鱼是阿里巴巴旗下的二手交易平台,提供RESTful API支持商品管理、订单处理、用户操作与数据统计。开发者可通过OAuth 2.0认证,使用App Key和access_token调用接口,实现自动化运营与第三方集成。本指南详解API核心功能、接入步骤、代码示例及最佳实践,助您高效开发。
12575 1
|
2月前
|
数据采集 人工智能 调度
中小企业AI搜索优化:低投入内容生产与引用验证路径
本文面向开发者,解析AI问答引擎引用内容的形成机制,提出“平台推荐—抓取频率—结构适配”三要素协同模型,提供可验证的选题、生产、分发与效果评估路径,并明确适用边界与常见失效模式。
233 0
|
2月前
|
JSON 算法 API
淘宝天猫商品评论API接口解析(附 JSON 样例)
本文详解淘宝开放平台taobao.item.reviews.get接口,合规获取商品近180天公开评价数据(含评分、文本、晒图、SKU、追评及商家回复),涵盖鉴权、签名、参数、JSON示例、字段释义与生产避坑指南。(239字)
|
4月前
|
数据采集 存储 缓存
什么是API选品比价?一篇带你从零到一
API选品比价是通过调用电商/供应商API,自动获取、清洗、比对商品价格与参数,实现7×24小时实时、规模化、多维度(价格、评分、物流等)智能选品的技术方案,助力企业降本增效。
|
4月前
|
数据采集 人工智能 缓存
1688 图搜 API 实战|从一张竞品图片,实现全自动溯源货源 + 跨平台快速上货
本方案介绍基于1688图搜API的自动化选品上货系统,支持图片上传→智能识图→货源匹配→数据采集→多平台批量铺货全流程。涵盖官方与第三方接口对比、风控策略、版权规避及SaaS/单机两种部署模式,助力无货源商家降本增效。
753 0
|
4月前
|
数据采集 API 数据库
上万商品一键搬迁!1688 自动化采集,同步自研电商系统完整实战
本方案提供合规高效的1688商品自动搬货解决方案:基于官方API采集,集成数据清洗(优化标题、标准化SKU、转换零售价)、图片本地化(去水印+OSS存储)、字段映射与定时增量同步,规避爬虫风险与超卖问题,助力自研电商/ERP快速接入货源。工具直达:o0b.cn/JeO6y3
624 0
|
4月前
|
供应链 安全 BI
API赋能供应链:基于京东开放接口的自动化采购询价落地方案
该平台通过对接京东开放API,实现采购询价全流程自动化:智能寻源、实时比价、成本核算、风控筛查与数据留痕,替代人工询价,提升效率、透明度与合规性,助力企业供应链数字化升级。
510 0
|
4月前
|
人工智能 自然语言处理 供应链
颠覆国货出海!反向海淘技术深度拆解:现状、痛点与千亿增长前景
反向海淘是海外消费者通过平台采购中国商品(淘宝、1688等)并跨境配送的新模式,以高性价比、小众SKU和集运拼单为特色。2025年市场规模超150亿美元,盈利远超传统跨境。技术驱动正推动行业进入自动化、AI化、合规化2.0阶段,API对接、智能清关、多语种AI运营与区块链溯源成核心壁垒。
463 0
|
5月前
|
算法 安全 API
《淘宝开放平台TOP API接入全指南:注册、AppKey获取、签名算法与沙箱调试(2026)》(附python源码)
淘宝开放平台(TOP)是淘宝/天猫官方API体系,区别于1688。本文涵盖注册、AppKey获取、MD5/HmacMD5签名(ASCII排序+首尾拼Secret)、沙箱调试(`tbsandbox.com`网关)及Python可运行示例,含`taobao.item.get`调通验证与避坑指南。(239字)

热门文章

最新文章