一次 GET 返回个人资料、公司、动态或职位的 JSON。
所有功能都在 GET /v1/linkedin 上。用 type 选择一种数据,传入一个 URL 或关键词,结果就会放在以该类型命名的字段下返回。
这个领域的大多数工具会把 LinkedIn 个人资料 API、公司 API 和职位 API 作为不同的产品分开定价。这里则是一个 LinkedIn 数据 API,只有一条计费规则:成功调用收取一个积分,空结果或无法访问的结果免费。
| type | 返回内容 | 输入 |
|---|---|---|
| profile | 完整的公开个人资料:姓名、简介、工作经历、教育背景、粉丝数等。默认类型。 | url(一个 linkedin.com/in/... URL) |
| refresh | 当前的公司和学校,以及它们的 LinkedIn 数字 id,还有 companyState。这是为保持数据库更新而设计的精简、低延迟调用。 | url |
| company | 公开的公司页面。加上 employees=true 可获取员工列表。 | url(一个 linkedin.com/company/... URL) |
| posts | 公开动态,每次调用最多 100 条。加上 comments=true 可获取每条动态的评论。 | url(个人资料或公司) |
| jobs | 公开职位信息,每次调用最多 50 条,可通过 start 分页。 | keywords 加上可选的 location,或者一个职位 url |
| search(测试版) | 人物搜索。加上 enrich=true 可在同一次调用中获取每个人的完整个人资料。 | keywords |
注意输入规则:profile、company 和 posts 接受 url,而不是搜索查询。如果你只有一个姓名,先用 type=search(测试版)找到这个人,再传入返回的个人资料 URL。
这是上面的 curl 返回的真实 JSON,为适应版面做了删减。它在 800 毫秒内返回,花费一个积分。
有两个字段值得注意。accessible 告诉你这个人是否有公开页面;当它为 false 时,profile 为 null,note 会说明原因,且这次调用不计费。
memberIdentifier 是 LinkedIn 永久的数字成员 id,它在姓名和自定义 URL 改变后依然不变,所以是数据库中理想的关联键。
完整的公开记录,结构化呈现。每次调用的结构都相同,所以你的解析器只需编写一次。
邮箱字段是可选开启的:在个人资料调用中加上 email=true,响应就会追加 workEmail 和 emailStatus。状态为 verified、pattern-likely 或 unknown,因此你可以筛选出真正确认过的地址。
邮箱只是个人资料调用上的一个附带字段,并不是单独的产品。
只有登录后才存在的字段,我们特意不返回。人脉列表、共同人脉、谁看过某份资料,从不出现在未登录页面上,所以都不在响应里。正是这条界限,让这个 API 无需任何账号即可运行,你的东西不承担任何风险。
只有少数几个通俗易懂的选项。其余一切都有合理的默认值。
| 参数 | 适用于 | 作用 |
|---|---|---|
| url | profile、refresh、company、posts、jobs | 一个 linkedin.com URL。profile、company 和 posts 必填。jobs 可以接受职位 URL 而不是关键词。 |
| keywords | search(测试版)、jobs | 要搜索的内容。search 必填;除非传入职位 URL,否则 jobs 也必填。 |
| location | jobs | 职位搜索的城市或地区筛选。 |
| limit | jobs、posts、search(测试版) | 返回多少条结果。jobs:默认 25,最多 50。posts:默认 50,最多 100。search:默认 10,最多 15。 |
| start | jobs | 分页的结果偏移量。 |
| profile | 在个人资料上追加 workEmail 和 emailStatus(verified、pattern-likely 或 unknown)。 | |
| domain | profile | 与 email=true 搭配使用。传入雇主的域名(例如 stripe.com),查找器就会直接使用它,而不是从资料中查出来。更快,并且即使某份资料被限制为仅显示姓名也能生效。 |
| enrich | search(测试版) | 在同一次调用中返回每个人的完整个人资料。按返回的每份完整资料收取一个积分,而不是每次调用一个积分。 |
| employees | company | 在公司页面中包含员工列表。 |
| comments | posts | 包含每条动态的评论。 |
| member | refresh | 同时返回 memberIdentifier。因为读取较慢所以需手动开启;这个 id 永不改变,取一次保存即可。 |
| headline | profile | 对于 companyState 为 restricted 的个人资料,尝试恢复该成员自己的公开简介。尽力而为,成功率大约二十分之一。 |
保持数据库更新,不应该每一行都要一次 HTTP 往返。在一次 POST 中发送最多 100 个个人资料 URL,结果会按输入顺序返回。
这些规则是为大批量运行设计的:结果会按你发送的顺序返回,某一行失败绝不会拖垮整个批次,格式错误的 URL 会作为单行错误返回,而不是计费。计费方式与单次端点一致,每成功一行收取一个积分,无法访问的行免费。
type 可以是 refresh(默认值,返回当前公司和学校及其数字 id)或 profile(完整记录),而 member: true 会在 refresh 行上追加 memberIdentifier。
从零到你的第一份资料 JSON,大约只要一分钟:
创建一个免费账户。你每月获得 3,000 积分,无需信用卡。
从仪表盘复制你的密钥。登录后的第一屏就能看到它。
用任意资料 URL 运行上面的 curl。公开资料会以 JSON 返回。
无论哪种类型,每次成功调用都是一个积分。私密或无法访问的资料会返回带说明的 null,且不计费,空的搜索结果也免费。
| 套餐 | 积分 | 你支付 |
|---|---|---|
| 免费额度 | 每月 3,000 | 0 美元,无需信用卡 |
| 25,000 次调用 | 25,000 | 49 美元(每 1,000 次 1.96 美元) |
| 100,000 次调用 | 100,000 | 149 美元(每 1,000 次 1.49 美元) |
| 500,000 次调用 | 500,000 | 549 美元(每 1,000 次 1.10 美元) |
| 2,500,000 次调用 | 2,500,000 | 1,999 美元(每 1,000 次 0.80 美元) |
套餐最高可达 2.5 亿积分,售价 100,000 美元,即每 1,000 次 0.40 美元。价格不含税。
积分为预付且永不过期。唯一的例外:带 enrich=true 的人物搜索(测试版)按其返回的每份完整资料收取一个积分。
相关内容:免登录抓取 LinkedIn · LinkedIn 个人资料抓取工具 · Bright Data LinkedIn 替代方案 · Proxycurl 替代方案
一个端点,GET /v1/linkedin,以干净的 JSON 返回公开的 LinkedIn 数据。把 type 设为 profile、refresh、company、posts、jobs 或 search(测试版)。个人资料、公司和动态需要一个 linkedin.com URL;职位和人物搜索需要关键词。每次成功调用是 1 个积分。
不需要。它只读取每个页面公开的、未登录的版本,所以不用粘贴 Cookie,不用交出会话,也没有你的任何账号参与其中。只有登录后才存在的字段,比如人脉列表,是我们特意排除在产品之外的。
每次成功调用一个积分,所有类型都一样。例外是带 enrich=true 的人物搜索(测试版),它按返回的每份完整资料收取 1 个积分。私密或无法访问的个人资料会返回带说明的 null,不计费;空结果也免费。免费额度是每月 3,000 个积分,无需信用卡。
姓名、简介、地点、about、粉丝数、带公司链接和日期的完整工作经历、教育背景、头像,以及稳定的标识符,包括 memberIdentifier(LinkedIn 永久的数字成员 id)。加上 email=true 可追加 workEmail,其 emailStatus 为 verified、pattern-likely 或 unknown。
使用 type=refresh,它以低延迟返回当前的公司和学校及其数字 id,并通过 POST /v1/linkedin/batch 发送资料,每次请求最多 100 个 URL,结果按输入顺序返回。失败的行绝不会拖垮整个批次,无法访问的行免费。
登出状态、仅采集公开数据的方式,已多次在计算机欺诈和合同类诉讼中胜出。采集由我们处理,你得到的是任何人都能看到的公开数据。我们不使用虚假账号或登录。
从每月免费的 3,000 个积分开始,无需信用卡。一次 GET 就能以干净的 JSON 返回公开个人资料,无法访问的资料则完全不收费。你的任何账号都不会成为请求的一部分。
领取 3,000 个免费积分