> ## 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.

# 在5分钟内抓取您的第一个LinkedIn个人资料

> 设置Bright Data LinkedIn Scraper API，在5分钟内收集您的第一个个人资料数据。

本教程向您展示如何使用Bright Data LinkedIn Scraper API抓取LinkedIn个人资料并获取结构化的JSON数据。

## 前置条件

* 一个[Bright Data账户](https://www.bright.cn/products/web-scraper/linkedin?hs_signup=1\&utm_source=docs)（每月含 5,000 个免费积分）
* 已安装cURL、Python 3.9+或Node.js 18+

<Steps>
  <Step title="获取您的API密钥">
    进入您的Bright Data账户中的[用户设置页面](https://www.bright.cn/cp/setting/users)并创建一个 API 密钥，或使用已有的密钥。

    如果您还没有账户，请[在brightdata.com注册](https://www.bright.cn/products/web-scraper/linkedin?hs_signup=1\&utm_source=docs)。新账户每月可获得 5,000 个免费积分，无需信用卡。请参阅[免费套餐](/cn/general/account/billing-and-pricing/free-tier)。

    <Warning>
      您的API密钥仅在创建时显示一次。请复制并安全地存储它。
    </Warning>
  </Step>

  <Step title="发送请求">
    我们将使用**Profiles端点**。最快的方式是使用 Bright Data Python SDK（`pip install brightdata-sdk`），它会替您等待结果。其他选项卡通过同步请求直接调用 API。将`YOUR_API_KEY`替换为您的实际密钥：

    <CodeGroup>
      ```python Python SDK theme={null}
      # pip install brightdata-sdk
      from brightdata import SyncBrightDataClient

      # The Scraper API uses no zones, so skip the SDK's zone setup
      with SyncBrightDataClient(token="YOUR_API_KEY", auto_create_zones=False) as client:
          result = client.scrape.linkedin.profiles(url="https://www.linkedin.com/in/satyanadella")
          print(result.data)
      ```

      ```bash cURL theme={null}
      curl -X POST \
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json" \
        -H "Authorization: Bearer YOUR_API_KEY" \
        -H "Content-Type: application/json" \
        -d '[{"url": "https://www.linkedin.com/in/satyanadella"}]'
      ```

      ```python Python theme={null}
      import requests

      response = requests.post(
          "https://api.brightdata.com/datasets/v3/scrape",
          params={"dataset_id": "gd_l1viktl72bvl7bjuj0", "format": "json"},
          headers={
              "Authorization": "Bearer YOUR_API_KEY",
              "Content-Type": "application/json",
          },
          json=[{"url": "https://www.linkedin.com/in/satyanadella"}],
      )

      data = response.json()
      if response.status_code == 202:
          print(f"Job running. Snapshot ID: {data['snapshot_id']}")
      else:
          print(data)
      ```

      ```javascript Node.js theme={null}
      const response = await fetch(
        "https://api.brightdata.com/datasets/v3/scrape?dataset_id=gd_l1viktl72bvl7bjuj0&format=json",
        {
          method: "POST",
          headers: {
            "Authorization": "Bearer YOUR_API_KEY",
            "Content-Type": "application/json",
          },
          body: JSON.stringify([
            { url: "https://www.linkedin.com/in/satyanadella" }
          ]),
        }
      );

      const data = await response.json();
      if (response.status === 202) {
        console.log(`Job running. Snapshot ID: ${data.snapshot_id}`);
      } else {
        console.log(data);
      }
      ```
    </CodeGroup>

    SDK 会输出 `result.data` 中返回的记录。它最多等待 180 秒获取结果，因此您无需自行处理 `202`。使用 cURL、Python 或 Node.js 时，您应该看到 `200` 状态码和一个 JSON 数组。`202` 表示抓取需要超过 1 分钟，请参阅下方说明。处理时间取决于目标网站状况和爬虫负载。

    <Note>
      同步请求最多等待 1 分钟。如果 Bright Data LinkedIn Scraper API 需要更长时间，响应为 HTTP `202`，返回 `snapshot_id` 而不是个人资料数据，采集将继续以异步方式进行。请通过[异步工作流](/cn/products/scrapers/scrapers-library/async-requests)获取结果，或使用 [Webhook 投递](/cn/products/scrapers/scrapers-library/data-delivery)接收结果。
    </Note>
  </Step>

  <Step title="查看响应">
    Bright Data LinkedIn Scraper API返回一个JSON数组，其���包含结构化的个人资料数据：

    ```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,
        "connections": 500,
        "url": "https://ar.linkedin.com/in/satyanadella",
        "id": "satyanadella",
        "position": "Chairman and CEO at Microsoft",
        "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."
      }
    ]
    ```

    2026 年 9 月 6 日抓取时，每个个人资料对象包含 42 个顶层字段，涵盖身份、位置、当前公司、关注者数量和社交动态。请查看[完整响应架构](/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url)。
  </Step>
</Steps>

您已成功使用Bright Data LinkedIn Scraper API抓取了您的第一个LinkedIn个人资料。

<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>

## 常见问题

### 我可以在一个请求中抓取多个个人资料吗？

可以。将更多对象添加到输入数组。Bright Data 建议每个同步请求不超过 20 个 URL，这是最佳实践，而非硬性限制。对于更大的批次，请使用[异步`/trigger`端点](/cn/products/scrapers/scrapers-library/async-requests)。

```json theme={null}
[
  {"url": "https://www.linkedin.com/in/satyanadella"},
  {"url": "https://www.linkedin.com/in/jeffweiner08"},
  {"url": "https://www.linkedin.com/in/rbranson"}
]
```

### 收到401或403错误？

验证您的API密钥是否正确且未过期。从[账户设置](https://www.bright.cn/cp/setting/users)生成新密钥。有关详细信息，请查看[身份验证指南](/api-reference/authentication)。

### 请求超时？

同步请求有1分钟的超时时间。如果请求超过此限制，API 返回 HTTP `202` 和 `snapshot_id`，并以异步方式完成任务。对于大批量请求，请使用[异步工作流](/cn/products/scrapers/scrapers-library/async-requests)。

### 响应数据为空或不完整？

验证LinkedIn个人资料URL是否可公开访问且格式正确。URL应遵循`https://www.linkedin.com/in/username`的格式。

## 必须直接调用 API 吗？

不必。Bright Data 的 SDK、CLI 和编程代理工具调用的是同一个 Scraper API，您可以选择最适合自己技术栈的方式开始。

| 客户端 | 安装 | 第一次调用 |
| :- | :- | :- |
| **Python 和 Node.js SDK** | `pip install brightdata-sdk` 或 `npm install @brightdata/sdk` | `client.scrape.linkedin.profiles(url="https://www.linkedin.com/in/satyanadella")`；详见 [Python SDK](/cn/api-reference/SDK) 和 [JavaScript SDK](/cn/api-reference/SDK-JS) |
| **CLI** | `npm install -g @brightdata/cli`，然后 `bdata login` | `bdata pipelines linkedin_person_profile "https://www.linkedin.com/in/satyanadella" --pretty`；详见 [CLI 命令](/cn/products/cli/commands) |
| **编程代理** | `npx skills add brightdata/skills` 安装技能；[Bright Data MCP](/cn/products/mcp-server/overview) 服务器将爬虫作为工具暴露 | 详见[编程代理快速开始](/cn/quickstart-coding-agent) |

## 后续步骤

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

  <Card title="异步批量请求" icon="layer-group" href="/cn/products/scrapers/scrapers-library/async-requests">
    在单个批处理作业中抓取数百个URL。
  </Card>

  <Card title="设置webhooks" icon="webhook" href="/cn/products/scrapers/scrapers-library/data-delivery">
    在抓取完成时自动接收结果。
  </Card>
</CardGroup>
