> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LinkedIn Scraper API

> 使用 Bright Data LinkedIn Scraper API 从个人资料、公司、职位和帖子中提取结构化数据。同步请求建议每次不超过 20 个 URL。

发送一个 LinkedIn URL，即可获得结构化的 JSON 返回。Bright Data LinkedIn Scraper API 负责处理代理、验证码和解析，让你可以专注于自己的数据管道。

<Tip>
  初次使用 Bright Data？[创建免费账户](https://www.bright.cn/products/web-scraper/linkedin?hs_signup=1\&utm_source=docs)，即可**每月获得 5,000 个免费积分**，无需信用卡。这相当于最多 **5,000 条 LinkedIn 记录**，可供你开始抓取。请参阅[免费套餐](/cn/general/account/billing-and-pricing/free-tier)。
</Tip>

## 工作原理

你向 Bright Data LinkedIn Scraper API 发送一个或多个 LinkedIn URL。Bright Data 负责处理抓取基础设施，并返回干净的结构化 JSON。

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

所有请求都使用 `dataset_id` 来指定数据类型（个人资料、公司、职位或帖子），并以 NDJSON（默认）、JSON、JSON lines、CSV 和 Parquet 格式返回结果。见[输出格式](/cn/products/scrapers/scrapers-library/data-delivery#支持哪些输出格式)。

## 响应内容示例

Bright Data LinkedIn Scraper API 于 2026 年 9 月 6 日返回的单条记录（已裁剪为所示字段）。可在[快速开始](/cn/products/scrapers/linkedin/quickstart)中亲自发送该请求。

```json theme={null}
{
  "name": "Satya Nadella",
  "city": "Redmond, Washington, United States",
  "country_code": "US",
  "current_company": {
    "name": "Microsoft",
    "company_id": "microsoft",
    "title": "Chairman and CEO",
    "location": "Greater Seattle Area"
  },
  "followers": 12151763,
  "about": "As chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
  "id": "satyanadella",
  "position": "Chairman and CEO at Microsoft",
  "url": "https://ar.linkedin.com/in/satyanadella",
  "educations_details": "The University of Chicago Booth School of Business"
}
```

## 支持的数据类型

<CardGroup cols={2}>
  <Card title="个人资料" icon="user" href="/cn/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    身份信息、所在地区、当前公司、关注者数量。可按姓名或关键词发现个人资料。
  </Card>

  <Card title="公司" icon="building" href="/cn/api-reference/scrapers/social-media-apis/linkedin-companies-collect-by-url">
    员工人数、融资数据、专长领域、关联组织。
  </Card>

  <Card title="职位" icon="briefcase" href="/cn/api-reference/scrapers/social-media-apis/linkedin-jobs-collect-by-url">
    薪资数据、任职要求、申请链接。可按关键词或搜索 URL 发现职位。
  </Card>

  <Card title="帖子" icon="message" href="/cn/api-reference/scrapers/social-media-apis/linkedin-posts-collect-by-url">
    帖子内容、互动指标、话题标签、评论。可按公司或个人资料发现帖子。
  </Card>
</CardGroup>

## 数据集 ID

每种 LinkedIn 数据类型使用自己的 `dataset_id`。在每个请求上将 ID 作为查询参数传递。

| 数据类型 | 数据集 ID |
| :- | :- |
| 个人资料 | `gd_l1viktl72bvl7bjuj0` |
| 公司 | `gd_l1vikfnt1wgvvqz95w` |
| 职位 | `gd_lpfll7v5hcqtkxl6l` |
| 帖子 | `gd_lyy3tktm25m4avu764` |
| 发现新资料 | `gd_m8d03he47z8nwb5xc` |

## 请求方式

Bright Data Scraper API 支持两种请求方式，请根据您的数据量和延迟需求选择。

| 方式 | 端点 | 适用场景 |
| :- | :- | :- |
| **同步** | `/scrape` | 实时查询，最多 20 个 URL |
| **异步** | [`/trigger`](/cn/products/scrapers/scrapers-library/async-requests) | 批量任务、20 个及以上 URL、生产环境管道 |

详见[了解同步与异步请求](/cn/concepts/sync-vs-async)。

两个端点都接受带 `input` 数组的对象，可附加 `limit_per_input` 和 `custom_output_fields`，在 `/trigger` 上还可附加 `deliver` 配置。也接受由输入组成的纯 JSON 数组，本页示例使用此格式。详见[请求体](/cn/api-reference/scrapers/synchronous-requests#请求体)。

## 功能与限制

| 功能 | 详情 |
| :- | :- |
| **输出格式** | NDJSON（默认）、JSON、JSON lines、CSV 和 Parquet（[各格式适用范围](/cn/products/scrapers/scrapers-library/data-delivery#支持哪些输出格式)） |
| **同步请求最大 URL 数** | 20 |
| **异步请求最大 URL 数** | 无限制，每个任务最多 1 GB 输入 |
| **数据新鲜度** | 实时（按需抓取） |
| **投递方式** | API 下载、[webhook](/cn/products/scrapers/scrapers-library/data-delivery)、[Amazon S3](/cn/products/scrapers/scrapers-library/data-delivery)、Snowflake、Azure、GCS（[全部目标](/cn/products/scrapers/scrapers-library/data-delivery)） |
| **计费** | 按成功记录计费（[查看价格](https://www.bright.cn/pricing/web-scraper)） |

## 常见问题

<Note>
  自 2025 年 11 月 13 日起，LinkedIn 限制了对 **Position（职位）**、**Experience（工作经历）** 和 **Education（教育背景）** 三个字段的公开访问。这三个字段的填充率已从 50-64% 降至约 2%，目前返回的是缓存中的固定数据，而非实时抓取结果。除 `current_company.industry` 自 2025 年 8 月 7 日起不再支持外，其他所有字段均正常刷新。完整的字段状态表和替代方案，请参阅 [LinkedIn 数据政策变更](/cn/products/scrapers/linkedin/data-policy-change)。
</Note>

### 数据是实时抓取的吗？

是的。每次请求都会触发一次实时抓取。但有一个例外：自 2025 年 11 月 13 日 LinkedIn 限制以来，Position、Experience 和 Education 字段来自缓存（见上方说明）。其他所有字段均为实时数据。处理时间取决于目标网站状况和爬虫负载。Bright Data LinkedIn Scraper API 不公布固定的响应时间。同步请求最多等待 1 分钟，之后返回 HTTP `202` 和 `snapshot_id`，并继续以异步方式采集。发现（discovery）请求始终以异步方式运行，耗时更长，具体取决于结果数量。

### 响应时间为什么会发生变化？

LinkedIn 会调整其页面的提供方式，Bright Data LinkedIn Scraper API 的采集器也会相应更新。即使成功率保持不变，采集器更新也可能改变一次采集所需的时间。对于生产环境的工作负载，请基于[异步工作流](/cn/products/scrapers/scrapers-library/async-requests)或 [Webhook 投递](/cn/products/scrapers/scrapers-library/data-delivery)进行构建，这样较长的运行时间不会破坏集成。

### URL 采集与发现有什么区别？

**URL 采集**会抓取你提供的特定 LinkedIn 页面（例如某个个人资料 URL）。**发现**会查找符合搜索条件的 LinkedIn 页面（例如"旧金山的软件工程师"）并抓取结果。发现请求在两个端点上均可使用。在 `/scrape` 上通常会超过 1 分钟限制并返回 HTTP `202` 和 `snapshot_id`，因此发现请求请使用异步 [`/trigger`](/cn/products/scrapers/scrapers-library/async-requests) 端点。

### 与使用代理或 Web Unlocker API 抓取有何不同？

使用代理或 Web Unlocker API 抓取时，您仍需编写和维护自己的解析逻辑，并在目标网站页面结构变化时随时更新。Bright Data Scraper API 处理整个链路：代理轮换、反爬绕过与解析。您只需发送 URL 或关键词，即可获得干净的结构化 JSON，无需自建抓取基础设施或维护解析器。

## 后续步骤

<CardGroup cols={3}>
  <Card title="快速开始" icon="rocket" href="/cn/products/scrapers/linkedin/quickstart">
    5 分钟内抓取你的第一份 LinkedIn 个人资料。
  </Card>

  <Card title="端点" icon="bolt" href="/cn/products/scrapers/linkedin/send-first-request">
    每个端点一个请求，附实际抓取的响应。
  </Card>

  <Card title="API 参考" icon="code" href="/cn/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    端点规范、参数和响应模式。
  </Card>
</CardGroup>