Goodfish｜ item_get（商品详情）接口完整数据明细 - Tigshop

闲鱼 item_get（商品详情）接口完整数据明细、字段说明、JSON 示例、调用参数与合规提示，直接对接可用。

一、接口基础信息
接口名：goodfish.item_get（第三方通用命名，闲鱼无官方公开商品详情 API）
功能：传入商品 ID（item_id/num_iid），返回商品全量结构化详情
请求方式：GET/POST
必传参数：item_id（闲鱼商品唯一 ID，从链接中提取，如https://2.taobao.com/item.htm?id=750828541223 → id=750828541223）
认证：第三方服务商一般需app_key+sign签名，部分需 token / 账号授权
二、完整返回数据结构（JSON）+ 字段明细

 
""" Compatible for python2.x and python3.x requirement: pip install requests """
 
from __future__ import print_function import requests
 
# 配置参数 API_ url=o0b.cn/ibrad， wechat id:  TaoxiJd-api 复制链接获取测试 "
app_key = "YOUR_APP_KEY" num_id = "123456" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码 url = "goodfish/item_get/?
key=<您自己的apiKey>&num_iid=123456" headers = { "Accept-Encoding": "gzip", "Connection": "close" } 
if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() 
print(json_obj)

商品核心信息（item）
字段名类型示例说明
item_id / num_iid String "750828541223" 商品唯一 ID，主键
title String "iPhone 15 Pro Max 256G 银色 99 新无拆修" 商品标题
sub_title String "个人自用原装无修功能全好" 副标题 / 卖点
price Float 7800.00 当前售价（元）
original_price Float 9999.00 原价 / 专柜价（二手常用）
condition String "99 新" 成色：全新 / 99 新 / 95 新 / 九成新 / 八成新 / 七成新及以下
status String "onsale" 商品状态：onsale (在售)/sold (已售)/offline (下架)
desc String "个人一手，无拆无修，电池健康 92%..." 商品描述（含 HTML / 换行）
desc_plain String "纯文本描述（去标签）" 纯文本版描述
category_id String "50012081" 类目 ID
category_name String "手机 / 数码 / 手机" 类目名称
brand String "Apple" 品牌
model String "iPhone 15 Pro Max" 型号
created String "2025-10-20 14:30:00" 发布时间
location String "广东深圳" 发货地 / 所在地
post_fee Float 0.00 运费（0 = 包邮）
post_type String "快递" 配送方式：快递 / 自提 / 同城配送
图片 / 视频（item_imgs）
字段名类型示例说明
pic_url String "https://img.alicdn.com/imgextra/i4/xxx.jpg" 主图 URL
item_imgs Array ["https://...1.jpg","https://...2.jpg"] 多图列表（最多 9 张）
video_url String "https://cloud.video.taobao.com/play/u/xxx/p/1/e/6/t/1/xxx.mp4" 商品视频直链（有则返回）
扩展标签 / 属性（extend）
字段名类型示例说明
tags Array ["包邮","可小刀","原装","无拆修"] 商品标签
props Array [{"name":"容量","value":"256G"},{"name":"颜色","value":"银色"}] 规格属性
service_tags Array ["7 天无理由","正品保障"] 服务标签
is_new Bool false 是否全新
is_free_shipping Bool true 是否包邮
三、完整 JSON 返回示例（精简版）

  "code": 200,
  "msg": "success",
  "data": {
    "item": {
      "item_id": "750828541223",
      "title": "iPhone 15 Pro Max 256G 银色 99新",
      "price": 7800.00,
      "original_price": 9999.00,
      "condition": "99新",
      "status": "onsale",
      "desc": "个人自用，无拆无修，电池92%，功能全好，配件齐全",
      # 封装好API demo url=o0b.cn/ibrad
      "created": "2025-10-20 14:30:00",
      "location": "广东 深圳",
      "post_fee": 0.00,
      "category_name": "手机/数码/手机"
    },
    "seller": {
      "nick": "小鱼数码",
      "credit_level": "极好",
      "good_rate": "99.2%",
      "seller_type": "personal"
    },
    "item_imgs": [
      "https://img.alicdn.com/imgextra/i4/xxx.jpg",
      "https://img.alicdn.com/imgextra/i4/xxx_2.jpg"
    ],
    "trade": {
      "stock": 1,
      "collect_num": 89,
      "want_num": 5,
      "can_bargain": true
    },
    "extend": {
      "tags": ["包邮","可小刀","原装"],
      "props": [{"name":"容量","value":"256G"},{"name":"颜色","value":"银色"}]
    }
  }
}

四、调用与合规要点（必看）
无官方公开 API：闲鱼未开放商品详情官方接口，市面均为第三方封装 / 爬虫封装，存在风控、限流、封号、数据不准风险
频率限制：单 IP / 账号建议1/ 秒/ 次，批量需加代理、资源池，避免 403 / 封禁
字段差异：不同第三方服务商返回字段命名可能略有差异（如 num_iid/item_id、price/current_price），以对接的服务商文档为准