如何通过LinkedIn API按姓名获取第三方成员资料URN

前提准备 #

• 注册LinkedIn开发者账号，创建专属应用，获取client ID和client secret两个核心凭证。
• 向LinkedIn申请符合业务场景的API权限：搜索用户的权限需通过平台审核，常用基础权限包括r_liteprofile（获取用户基础资料），具体权限需根据业务需求提交申请。
• 完成OAuth2授权流程，拿到有效的access token——所有API请求都必须携带这个令牌验证身份。

执行姓名搜索 #

调用LinkedIn的People Search API端点发起请求：

• 请求方式：GET
• 端点地址：https://api.linkedin.com/v2/people-search
• 请求参数：通过keywords参数传入目标姓名，还可附加location、industry等参数缩小搜索范围，示例参数：keywords=张三&location=中国
• 注意：LinkedIn对搜索API的调用频率、返回结果范围有严格限制，仅返回你有权限访问的用户（比如已授权用户的人脉、符合合规场景的用户），无法搜索任意公开用户。

提取成员URN #

API返回的JSON响应中，每个用户条目里的id字段就是该成员的URN，格式通常为urn:li:person:xxxxxx。

示例响应片段：

{
  "elements": [
    {
      "id": "urn:li:person:123456789",
      "firstName": { "localized": { "zh_CN": "张" }, "preferredLocale": { "country": "CN", "language": "zh" } },
      "lastName": { "localized": { "zh_CN": "三" }, "preferredLocale": { "country": "CN", "language": "zh" } }
    }
  ]
}

直接提取id字段即可得到目标成员的URN。

重要注意事项 #

• 合规性：LinkedIn禁止第三方应用滥用搜索API，你的应用必须符合平台的API使用政策（比如招聘、合法商务拓展场景），否则可能被封禁权限。
• 隐私保护：获取的用户数据仅能用于授权的业务用途，严格遵守LinkedIn的用户隐私条款。
• API版本：确保使用最新的v2版本API，旧版本API已逐步废弃。

内容的提问来源于stack exchange，提问作者Ravi