获取指定房产经纪人的职业档案

查看 美国房产与房贷数据 API 的全部接口 →

通过必填查询参数 profile_id 获取经纪人档案。该值取自 /agents/v2/list 所选结果的 id 字段;可选参数 fulfillment_id 则取自同一结果的 fulfillment_id 字段。两种标识需要分别保存和传递,不能相互替代。文档中的 profile_id 示例为 56d09a4b2cfde1010000abb1,fulfillment_id 未提供默认值。 现有文档示例列出了档案标识 id 和 _id,姓名及简介字段 fullname、profile_name、bio 和 profile_description,以及包含 line、city、postal_code、state、state_code 和 country 的 address 对象。示例还包括表示买方、卖方代理身份的布尔值 agent_represents.buyer 和 agent_represents.seller、字符串 areas_served,以及 languages 和 licenses 数组;这两个数组的示例均为空,因此无法据此确定数组项结构。此外,示例包含带有 name 和 fulfillment_id 的 broker、office 对象,照片地址 photo.href,以及档案更新时间 meta.last_update_date。反馈相关字段包括 recommendations.count,以及 ratings 对象中的 average_rating、overall_rating、reviews_count 和 responseCount。评分字段混用了数值和字符串,不能假设所有字段都采用同一种数值类型。 上述字段仅来自未经实际响应验证的文档示例,并非返回保证:此接口没有可用的实测响应,且所提供的示例并不完整。接入时应兼容字段缺失,不要仅凭返回档案推断联系方式仍然有效、执照有效、照片可自由使用,或职业经历完整。若需要展示推荐反馈或评价,应分别调用对应的独立接口。

API 功能

从经纪人列表衔接档案查询 将经纪人列表所选结果的 id 作为必填 profile_id,让职业档案与用户选中的目录记录保持对应。
单独传递可选 fulfillment_id 同一列表结果提供 fulfillment_id 时,可将其作为独立参数传入,但不能用它替代必填的 profile_id。
职业简介与服务地区字段参考 未经实测验证的文档示例列有 fullname、bio、profile_description、address 和 areas_served,可用于设计兼容缺失值的档案页面。
买卖方代理与所属机构信息 示例记录了买方、卖方代理标记及 broker、office 对象,但这些字段不能证明执照有效,也不能确认当前机构归属。
档案数组与评分类型提示 空的 languages、licenses 数组不能确定数组项结构;评分值的类型也不统一,应逐字段处理,避免一律转换为数值。

在线 API 演示

GET /api/project/realty-in-us/agents-v2-get-profile

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-get-profile?key=<API_KEY>&profile_id=56d09a4b2cfde1010000abb1'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

查询档案所需的 profile_id 从哪里获取?

使用 /agents/v2/list 所选结果的 id 字段。profile_id 是必填字符串参数,文档示例为 56d09a4b2cfde1010000abb1;实际查询时应传入用户选中的经纪人标识。

获取经纪人档案必须传 fulfillment_id 吗?

不必。此接口要求传入 profile_id,fulfillment_id 则是可选字符串参数,其值来自经纪人列表结果的 fulfillment_id 字段。档案请求没有预设 fulfillment_id 默认值,两种标识不能互换。

文档列出了哪些经纪人职业资料?

不完整的文档示例包含姓名与简介、地址、areas_served 服务地区、买方和卖方代理标记、broker 和 office 对象、photo.href 及 meta.last_update_date。示例也列有 languages 和 licenses 数组,但空数组不能确定数组项结构。此接口尚无实际响应来确认这些字段。

返回档案是否代表经纪人持有有效执照?

不是。档案、代理标记或 licenses 字段都不等同于执照有效性认定。现有示例没有确定执照记录的结构及核验状态;如需确认资质,应另行向相关执照管理机构核查。

能将档案中的评分当作完整评价内容吗?

不能。示例包含评分汇总和 recommendations.count,并未确立评价条目集合的结构,而且评分值有的为字符串、有的为数值。需要展示评价或推荐反馈时,应使用各自的独立接口,并先核实实际返回结构,再渲染具体反馈。

相关接口

相关指南

查看订阅方案 →