当前位置：首页 > news >正文

58 同城 item_get - 获取详情数据接口对接全攻略：从入门到精通

news 2026/5/12 1:51:22

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 分钟内同步，保障详情数据时效性；
- 权限分级管控：基础详情（标题 / 价格 / 基本属性）对所有权限开放，敏感数据（联系人电话、精准位置）需企业资质 + 合规备案双重授权。
典型应用场景
1. 本地生活服务平台：整合 58 同城多品类信息，搭建一站式本地生活检索与交易平台；
2. 垂直领域数据中台：针对房产、招聘等单一领域，批量采集详情数据构建行业分析模型；
3. 中介 / 商家获客系统：获取目标客户信息详情，生成精准获客清单；
4. 比价 / 评测工具：抓取二手物品、二手车等价格与参数信息，实现跨平台比价。

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 加密，缺失任一参数会导致认证失败。