58 同城item_get接口（官方标准命名58 同城.item.get）是通过信息唯一 ID（item_id）获取全品类本地生活信息详情的核心接口，覆盖房产、招聘、二手车、二手物品、家政服务等 58 同城主流业务线。该接口采用HTTPS+AppKey/Secret 签名认证，支持 JSON/XML 双格式返回，具备字段丰富、数据实时、权限分级的特点，是构建本地生活服务平台、垂直领域数据中台的核心依赖。本攻略从接口认知、权限准备、实操对接、调试排错到生产级优化，提供全链路标准化指导。
一、接口核心认知：功能与适配场景
1. 接口定位与核心价值
- 核心功能：输入信息唯一 ID（
item_id，从item_search接口或 58 同城官网详情页提取），返回对应信息的全维度结构化详情；支持按需指定业务线（如房产、招聘）、字段过滤，兼顾数据完整性与响应速度；可联动item_search/city_list接口，实现 “城市筛选→列表检索→详情查看” 的完整业务闭环。 - 58 同城数据特性
- 多业务线全覆盖：一套接口适配房产（新房 / 二手房 / 租房）、招聘（全职 / 兼职）、二手车、二手物品等全品类信息，无需单独对接不同业务接口；
- 交易属性突出：返回信息包含联系人、联系方式、交易状态、报价有效期等核心交易字段，适配本地生活服务交易场景；
- 数据实时性强：信息上架、下架、价格调整等动态数据1 分钟内同步，保障详情数据时效性；
- 权限分级管控：基础详情（标题 / 价格 / 基本属性）对所有权限开放，敏感数据（联系人电话、精准位置）需企业资质 + 合规备案双重授权。
- 典型应用场景
- 本地生活服务平台：整合 58 同城多品类信息，搭建一站式本地生活检索与交易平台；
- 垂直领域数据中台：针对房产、招聘等单一领域，批量采集详情数据构建行业分析模型；
- 中介 / 商家获客系统：获取目标客户信息详情，生成精准获客清单；
- 比价 / 评测工具：抓取二手物品、二手车等价格与参数信息，实现跨平台比价。
2. 核心参数与返回字段
（1）请求参数（GET/POST 提交，需签名认证）
| 参数类型 | 参数名称 | 类型 | 是否必填 | 说明 | 应用示例 |
|---|---|---|---|---|---|
| 公共参数 | app_key | string | 是 | 应用密钥（开放平台获取） | 58_appkey_2026_abc123 |
| secret | string | 是 | 应用秘钥（开放平台获取） | 58_secret_2026_def456 | |
| api_name | string | 是 | 接口名称，固定为item_get | 58同城.item.get | |
| format | string | 否 | 响应格式，默认 JSON | json/xml | |
| v | string | 是 | 接口版本，固定为1.0 | 1.0 | |
| timestamp | string | 是 | 时间戳（秒级） | 1735689600 | |
| 业务参数 | item_id | string | 是 | 信息唯一 ID | 123456789（房产）/987654321（招聘） |
| cate_id | string | 否 | 业务线分类 ID（精准定位品类） | 1（房产）/2（招聘）/3（二手车） | |
| field_filter | string | 否 | 字段过滤（指定返回字段，逗号分隔） | title,price,contact_name,address | |
| need_contact | bool | 否 | 是否返回联系人信息（需高级权限） | true/false | |
| need_media | bool | 否 | 是否返回图片 / 视频 URL | true |
注意事项
item_id是唯一必填业务参数，不同业务线的item_id格式不同，需与cate_id匹配使用；timestamp参数需为秒级时间戳，与服务器时间误差不得超过 10 分钟，否则签名验证失败；- 签名生成需包含所有非空参数，按参数名 ASCII 升序排序后拼接
secret进行 MD5 加密，缺失任一参数会导致认证失败。
（2）返回核心字段（按业务线分类）
| 业务线 | 核心字段 | 说明 |
|---|---|---|
| 房产 |
)
