获取指定房产经纪人的职业档案
查看 美国房产与房贷数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 用户从 /agents/v2/list 选择经纪人后打开职业详情面板,将所选 id 传为 profile_id,而不是 fulfillment_id。
- 在获得同意的客户关系管理记录中补充返回的经纪人简介和办公机构信息,保留缺失状态,不虚构联系方式。
- 当响应包含 agent_represents 标记时展示买方或卖方代理板块,但不将这些标记解释为执照核验结果。
- 为档案标识和 fulfillment 标识分别设置存储列,避免后续推荐反馈或评价查询误用 profile_id。
- 将返回的 meta.last_update_date 作为档案元数据展示,不据此承诺所有职业信息均为最新。
常见问题
查询档案所需的 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,并未确立评价条目集合的结构,而且评分值有的为字符串、有的为数值。需要展示评价或推荐反馈时,应使用各自的独立接口,并先核实实际返回结构,再渲染具体反馈。