# 获取人才列表 批量获取人才摘要信息，包括人才 ID、人才基信息、教育经历、工作经历等。若需要获取人才详细信息请使用[获取人才详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/talent/get)接口。 ## 请求 基本 |   ---|--- HTTP URL | https://open.feishu.cn/open-apis/hire/v1/talents HTTP Method | GET 接口频率限制 | [20 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN) 支持的应用类型 | Custom App、Store App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用**
开启任一权限即可 | 获取人才信息(hire:talent:readonly)
更新人才信息(hire:talent) 字段权限要求 | **注意事项**：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请
获取用户 user ID(contact:user.employee_id:readonly) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use) ### 查询参数 名称 | 类型 | 必填 | 描述 ---|---|---|--- keyword | string | 否 | 搜索关键词，支持布尔语言（使用 and、or、not 连接关键词）
**示例值**：张三 and 产品经理 update_start_time | string | 否 | 最早更新时间，毫秒时间戳
**示例值**：1618500278663 update_end_time | string | 否 | 最晚更新时间，毫秒时间戳
**示例值**：1618500278663 page_size | int | 否 | 分页大小
**示例值**：10
**默认值**：`10`
**数据校验规则**：
- 最大值：`20` sort_by | int | 否 | 排序规则
**示例值**：1
**可选值有**：
- 1：按更新日期降序
- 2：按相关度降序
- 3：按投递时间降序
- 4：按入库时间降序
**默认值**：`1` page_token | string | 否 | 分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果
**示例值**：eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ== user_id_type | string | 否 | 用户 ID 类型
**示例值**：open_id
**可选值有**：
- open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。[了解更多：如何获取 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)
- union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。[了解更多：如何获取 Union ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-union-id)
- user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。[了解更多：如何获取 User ID？](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)
- people_admin_id：以 people_admin_id 来识别用户
**默认值**：`people_admin_id`
**当值为 `user_id`，字段权限要求**：
获取用户 user ID(contact:user.employee_id:readonly) query_option | string | 否 | 请求控制参数
**示例值**：ignore_empty_error
**可选值有**：
- ignore_empty_error：忽略结果为空时的报错 ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \- has_more | boolean | 是否还有更多项 page_token | string | 分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token items | talent\[\] | 人才摘要信息列表 id | string | 人才 ID，详情可查看：[获取人才详情](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/hire-v2/talent/get) is_in_agency_period | boolean | 是否在猎头保护期
**可选值有**：
- false：未在猎头保护期
- true：在猎头保护期 is_onboarded | boolean | 是否已入职
**可选值有**：
- false：未入职
- true：已入职 basic_info | talent_basic_info | 基本信息 name | string | 姓名 mobile | string | 手机 mobile_code | string | 手机国家区号，遵守国际统一标准，请参考[百度百科-国际长途电话区号](https://baike.baidu.com/item/%E5%9B%BD%E9%99%85%E9%95%BF%E9%80%94%E7%94%B5%E8%AF%9D%E5%8C%BA%E5%8F%B7%E8%A1%A8/12803495?fr=ge_ala) mobile_country_code | string | 手机国家代码，详情请查看：[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query) email | string | 邮箱 experience_years | int | 工作年限 age | int | 年龄 nationality | talent_nationality | 国籍（地区） nationality_code | string | 国家编码，详情请查看：[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query) zh_name | string | 国籍（地区）中文名 en_name | string | 国籍（地区）英文名 gender | int | 性别
**可选值有**：
- 1：男
- 2：女
- 3：其他 current_city | talent_city_info | 所在地点 city_code | string | 城市码，详情请查看：[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query) zh_name | string | 地点中文名 en_name | string | 地点英文名 hometown_city | talent_city_info | 家乡 city_code | string | 城市码，详情请查看：[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query) zh_name | string | 地点中文名 en_name | string | 地点英文名 preferred_city_list | talent_city_info\[\] | 期望工作地点 city_code | string | 城市码，详情请查看：[查询地点列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/location/query) zh_name | string | 地点中文名 en_name | string | 地点英文名 identification_type | int | 个人证件类型
**可选值有**：
- 1：中国 - 居民身份证
- 2：护照
- 3：中国 - 港澳居民居住证
- 4：中国 - 台湾居民来往大陆通行证
- 5：其他
- 6：中国 - 港澳居民来往内地通行证
- 9：中国 - 台湾居民居住证 identification_number | string | 个人证件号 birthday | int | 出生日期，秒时间戳 creator_id | string | 创建人 ID，与入参 `user_id_type` 类型一致 marital_status | int | 婚姻状况
**可选值有**：
- 1：已婚
- 2：未婚 current_home_address | string | 家庭住址 modify_time | string | 修改时间，毫秒时间戳 education_list | talent_education_info\[\] | 教育经历 id | string | 教育经历 ID degree | int | 学位
**可选值有**：
- 1：小学
- 2：初中
- 3：专职
- 4：高中
- 5：大专
- 6：本科
- 7：硕士
- 8：博士
- 9：其他 school | string | 学校名称 field_of_study | string | 专业 start_time | string | 教育经历的起始日期，精确到月份 end_time | string | 教育经历的结束时间，精确到月份 end_time_v2 | string | 结束时间-新，无「至今」传值。建议使用此字段，避免模糊的毕业时间影响候选人筛选 education_type | int | 学历类型
**可选值有**：
- 1：海外及港台
- 2：统招全日制
- 3：非全日制
- 4：自考
- 5：其他 academic_ranking | int | 成绩排名
**可选值有**：
- 5：前 5 %
- 10：前 10 %
- 20：前 20 %
- 30：前 30 %
- 50：前 50 %
- -1：其他 tag_list | int\[\] | 教育经历标签
**可选值有**：
- 1：985学校
- 2：211学校
- 3：一本
- 4：国外院校QS200 career_list | talent_career_info\[\] | 工作经历 id | string | 工作经历 ID company | string | 公司名称 title | string | 职位名称 desc | string | 工作经历描述 start_time | string | 工作经历的开始日期，精确到月份 end_time | string | 工作经历的结束日期，精确到月份 career_type | int | 经历类型
**可选值有**：
- 1：实习经历
- 2：工作经历
- 3：兼职经历
- 4：其他经历 tag_list | int\[\] | 工作经历标签
**可选值有**：
- 5：百度/阿里/腾讯
- 6：头条/美团/滴滴
- 14：互联网 100 强 project_list | talent_project_info\[\] | 项目经历 id | string | 项目经历 ID name | string | 项目名称 role | string | 项目角色 link | string | 项目链接 desc | string | 项目描述 start_time | string | 项目的开始日期，精确到月份 end_time | string | 项目的结束日期，精确到月份 works_list | talent_works_info\[\] | 作品 id | string | 作品 ID，可通过[获取附件信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/attachment/get)获取作品附件信息 link | string | 作品链接 desc | string | 作品描述 name | string | 作品附件名称 award_list | talent_award_info\[\] | 获奖 id | string | 获奖 ID title | string | 获奖名称 award_time | string | 获奖日期，精确到年份 desc | string | 获奖描述 language_list | talent_language_info\[\] | 语言能力 id | string | 语言能力 ID language | int | 语言
**可选值有**：
- 1：英语
- 2：法语
- 3：日语
- 4：韩语
- 5：德语
- 6：俄语
- 7：西班牙语
- 8：葡萄牙语
- 9：阿拉伯语
- 10：印地语
- 11：印度斯坦语
- 12：孟加拉语
- 13：豪萨语
- 14：旁遮普语
- 15：波斯语
- 16：斯瓦西里语
- 17：泰卢固语
- 18：土耳其语
- 19：意大利语
- 20：爪哇语
- 21：泰米尔语
- 22：马拉地语
- 23：越南语
- 24：普通话
- 25：粤语 proficiency | int | 精通程度
**可选值有**：
- 1：入门
- 2：日常会话
- 3：商务会话
- 4：无障碍沟通
- 5：母语 sns_list | talent_sns_info\[\] | 社交账号 id | string | 社交账号 ID sns_type | int | SNS 名称
**可选值有**：
- 1：领英
- 2：脉脉
- 3：微信
- 4：微博
- 5：Github
- 6：知乎
- 7：脸书
- 8：推特
- 9：Whatsapp
- 10：个人网站
- 11：QQ link | string | URL/ID resume_source_list | talent_resume_source\[\] | 简历来源 id | string | 简历来源 ID，详情请查看：[获取简历来源列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/resume_source/list) zh_name | string | 简历来源中文名 en_name | string | 简历来源英文名 interview_registration_list | talent_interview_registration_simple\[\] | 面试登记表 id | string | 面试登记表 ID，详情可查看：[获取面试登记表模板列表](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/interview_registration_schema/list) registration_time | int | 面试登记表创建时间，毫秒时间戳 resume_attachment_id_list | string\[\] | 简历附件 ID 列表（按照简历创建时间降序），详情请查看：[获取附件信息](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/attachment/get) top_degree | int | 最高学历
**可选值有**：
- 1：小学
- 2：初中
- 3：专职
- 4：高中
- 5：大专
- 6：本科
- 7：硕士
- 8：博士
- 9：其他 first_degree | int | 第一学历
**可选值有**：
- 1：低于大专
- 2：大专
- 3：本科
- 4：硕士
- 5：博士
- 6：其他
- 7：无 ### 响应体示例 ```json { "code": 0, "msg": "ok", "data": { "has_more": true, "page_token": "eyJvZmZzZXQiOjEwLCJ0aW1lc3RhbXAiOjE2Mjc1NTUyMjM2NzIsImlkIjpudWxsfQ==", "items": [ { "id": "6891560630172518670", "is_in_agency_period": true, "is_onboarded": true, "basic_info": { "name": "张三", "mobile": "182900291190", "mobile_code": "86", "mobile_country_code": "CN_1", "email": "16xx1@126.com", "experience_years": 5, "age": 22, "nationality": { "nationality_code": "CN_1", "zh_name": "中国", "en_name": "China" }, "gender": 1, "current_city": { "city_code": "CT_11", "zh_name": "北京", "en_name": "Beijing" }, "hometown_city": { "city_code": "CT_22", "zh_name": "成都", "en_name": "Chengdu" }, "preferred_city_list": [ { "city_code": "ST_47", "zh_name": "上海", "en_name": "Shanghai" } ], "identification_type": 1, "identification_number": "511699199x1x111234", "birthday": 293016767159, "creator_id": "ou_4c5ec7005d5e476175d5edfd3f1e5206", "marital_status": 1, "current_home_address": "南京路1号", "modify_time": "1634801678103" }, "education_list": [ { "id": "6891560630172518670", "degree": 1, "school": "湘港大学", "field_of_study": "考古", "start_time": "1990-01", "end_time": "1994-01", "end_time_v2": "1687180087000", "education_type": 1, "academic_ranking": 5, "tag_list": [ 1 ] } ], "career_list": [ { "id": "6891560630172518670", "company": "明日科技公司", "title": "高级工程师", "desc": "负责公司主页 UI 交互动画设计，行业领先水准", "start_time": "1990-01", "end_time": "1994-01", "career_type": 1, "tag_list": [ 6 ] } ], "project_list": [ { "id": "6891560630172518670", "name": "权限重构项目", "role": "项目负责人", "link": "www.recruitment-demo.com", "desc": "将系统的权限模块进行重构，支持更加灵活的权限控制能力。", "start_time": "1990-01", "end_time": "1991-01" } ], "works_list": [ { "id": "6891560630172518670", "link": "www.test.com", "desc": "全国 UI 设计大赛一等奖", "name": "全国 UI 设计大赛" } ], "award_list": [ { "id": "6891560630172518670", "title": "最佳新人奖", "award_time": "1991", "desc": "最优秀的新人奖" } ], "language_list": [ { "id": "6891560630172518670", "language": 1, "proficiency": 1 } ], "sns_list": [ { "id": "6891560630172518670", "sns_type": 1, "link": "www.test.com" } ], "resume_source_list": [ { "id": "6891560630172518670", "zh_name": "猎头", "en_name": "Hunter" } ], "interview_registration_list": [ { "id": "6833685612520950030", "registration_time": 1618494330932 } ], "resume_attachment_id_list": [ "64352523512563462" ], "top_degree": 1, "first_degree": 3 } ] } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 500 | 1002001 | 系统错误 | 请根据实际报错信息定位或咨询[技术支持](https://applink.feishu.cn/TLJpeNdW) 400 | 1002002 | 参数错误 | 检查参数是否正确，例如类型，大小 更多错误码信息，参见[通用错误码](https://open.feishu.cn/document/ukTMukTMukTM/ugjM14COyUjL4ITN)。