> ## 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 端点发送同步请求。

本指南介绍如何向每个 Bright Data LinkedIn Scraper API 端点发送同步请求。完成后，您将获得用于个人资料、公司、职位和帖子的工作示例。

## 前置条件

* 一个 [Bright Data 账户](https://www.bright.cn/products/web-scraper/linkedin?hs_signup=1\&utm_source=docs)，具有有效的 API 密钥
* 已完成 [快速入门](/cn/products/scrapers/linkedin/quickstart)

## 请求结构

每个同步请求都遵循相同的模式：

```
POST https://api.brightdata.com/datasets/v3/scrape?dataset_id={DATASET_ID}&format=json
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[{"url": "https://www.linkedin.com/..."}]
```

端点之间唯一改变的是 `dataset_id` 和输入 URL 格式。

<Note>
  `/scrape` 端点专为实时的单 URL 请求设计。Bright Data 建议每个请求不超过 20 个 URL（这是最佳实践，而非硬性限制），端点最多等待 1 分钟。如果采集耗时更长，响应为 HTTP `202`，返回 `snapshot_id` 而不是数据，采集将继续以异步方式进行。请通过[异步请求](/cn/products/scrapers/scrapers-library/async-requests)获取结果，或使用 [Webhook 投递](/cn/products/scrapers/scrapers-library/data-delivery)接收结果。
</Note>

## 个人资料

**数据集 ID：** `gd_l1viktl72bvl7bjuj0`

```bash 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"}]'
```

您应该看到 `200` 响应。处理时间取决于目标网站状况和爬虫负载。

<Accordion title="示例响应">
  ```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"
      },
      "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.",
      "followers": 12151763,
      "connections": 500,
      "id": "satyanadella",
      "position": "Chairman and CEO at Microsoft",
      "url": "https://ar.linkedin.com/in/satyanadella"
    }
  ]
  ```
</Accordion>

[完整个人资料响应模式](/cn/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url)

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

### LinkedIn 个人资料抓取器返回哪些输出字段？

LinkedIn 个人资料抓取器（`gd_l1viktl72bvl7bjuj0`，`collect_by_url`）返回 42 个输出字段。字段说明保留 API 返回的英文原文。

<Accordion title="输出字段（42）">
  | 字段 | 类型 | 说明 |
  | - | - | - |
  | `id` | text | A unique identifier for the person's LinkedIn profile |
  | `name` | text | Profile name |
  | `city` | text | Geographical location of the user |
  | `country_code` | text | Geographical location of the user |
  | `position` | text | The current job title or position of the profile<br />\*\*注意：\*\*自 2025 年 11 月 13 日起受 LinkedIn 限制，通常为空。 |
  | `about` | text | A concise profile summary. In some cases, only a truncated version with "…" is displayed on the website, and this is the version we capture |
  | `posts` | array | Contains information related to the user's last LinkedIn posts. It typically includes the post title, created date, URL link to the post, etc. |
  | `current_company` | object | Provides information about the user's current professional position. It typically includes the company name, the user's job title, the company ID, and the industry or sector to which the company belongs |
  | `experience` | array | Contains information about user's professional history. It typically includes the user's job title, length of time the user held the position, the geographic location of the company, the start and end date, the company name, URL link to the company profile, etc.<br />\*\*注意：\*\*自 2025 年 11 月 13 日起受 LinkedIn 限制，通常为空。 |
  | `url` | url | URL that link directly to the LinkedIn profile |
  | `people_also_viewed` | array | Provides a list of LinkedIn profiles that users who have viewed the user's profile, have viewed these as well |
  | `educations_details` | text | Provides information about the user's educational background |
  | `education` | array | Provides information about the user's educational background. It typically includes the degree, the start and end year, the filed, etc.<br />\*\*注意：\*\*自 2025 年 11 月 13 日起受 LinkedIn 限制，通常为空。 |
  | `recommendations_count` | number | A numeric count of the total number of recommendations that the user has received |
  | `avatar` | url | URL that link to the profile picture of the LinkedIn user |
  | `courses` | array | Contains information about courses or educational programs that the user has undertaken |
  | `languages` | array | Contains information about the user's proficiency in different languages |
  | `certifications` | array | Licenses & Certifications |
  | `recommendations` | array | Recommendations that the user has received from their connections or colleagues on LinkedIn |
  | `volunteer_experience` | array | Contains information related to the user's volunteer work |
  | `followers` | number | How many users/ companies following the profile |
  | `connections` | number | How many connections the profile has |
  | `current_company_company_id` | text | The id of the latest/current company of the profile |
  | `current_company_name` | text | The name of the latest/current company of the profile |
  | `publications` | array | Published works or presentations |
  | `patents` | array | Patents filed or granted |
  | `projects` | array | Professional or academic projects |
  | `organizations` | array | Memberships in professional organizations |
  | `location` | text | Geographical location of the user |
  | `input_url` | url | The URL that was entered when starting the scraping process |
  | `linkedin_id` | text | LinkedIn profile identifier |
  | `activity` | array | Any activity the user has regarding posts |
  | `linkedin_num_id` | text | Numeric LinkedIn profile ID |
  | `banner_image` | url | Banner image |
  | `honors_and_awards` | array | Awards and recognitions received |
  | `similar_profiles` | array | Profiles similar to the current one |
  | `default_avatar` | boolean | Is the avatar picture the default avatar empty picture |
  | `memorialized_account` | boolean | Boolean indicating if the account is memorialized |
  | `bio_links` | array | External links added to the bio |
  | `first_name` | text | First name of the user |
  | `last_name` | text | Last name of the user |
  | `influencer` | boolean | Indicator if the profile marked as influencer |
</Accordion>

包含输入 schema 的机器可读版本：[`/scrapers/gd_l1viktl72bvl7bjuj0.json`](/scrapers/gd_l1viktl72bvl7bjuj0.json)

## 公司

**数据集 ID：** `gd_l1vikfnt1wgvvqz95w`

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

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "name": "Microsoft",
      "followers": 29034884,
      "employees_in_linkedin": 232354,
      "about": "Every company has a mission. What's ours? To empower every person and every organization to achieve more. We believe technology can and should be a force for...",
      "industries": "Software Development",
      "company_size": "10,001+ employees",
      "headquarters": "Redmond, Washington",
      "website": "https://news.microsoft.com/",
      "id": "microsoft",
      "country_code": "US,AU,CA,FR,DE,JP,GB,DK,BE,FI,IT,KR,NL,NO,ES,SE,CH,BR,CN,IN,MX,RU,ZA,TR,AT,HK,IE,IL,NZ,PL,PT,SA,SG,SK,TW,AE,AR,CL,CO,EG,ID,MY,PH,RO,TH"
    }
  ]
  ```
</Accordion>

[完整公司响应模式](/cn/api-reference/scrapers/social-media-apis/linkedin-companies-collect-by-url)

### LinkedIn 公司抓取器返回哪些输出字段？

LinkedIn 公司抓取器（`gd_l1vikfnt1wgvvqz95w`，`collect_by_url`）返回 36 个输出字段。字段说明保留 API 返回的英文原文。

<Accordion title="输出字段（36）">
  | 字段 | 类型 | 说明 |
  | - | - | - |
  | `id` | text | Unique to each company |
  | `name` | text | The name of the company |
  | `country_code` | text | The country where the company is located or headquartered |
  | `locations` | array | General information about the company's locations |
  | `followers` | number | The number of followers the company has on LinkedIn |
  | `employees_in_linkedin` | number | The number of employees listed on LinkedIn |
  | `about` | text | A description or summary of the company |
  | `specialties` | text | List of the company's specializations |
  | `company_size` | text | The number of employees in the company, as reported by the company |
  | `organization_type` | text | The type of organization |
  | `industries` | text | The industries to which the company belongs |
  | `website` | text | The official website of the company |
  | `crunchbase_url` | text | URL linking to the company's profile on Crunchbase |
  | `founded` | number | The year in which the company was founded |
  | `company_id` | text | A unique identifier for the company |
  | `employees` | array | Additional information about the company's employees |
  | `headquarters` | text | The location of the company's headquarters |
  | `image` | url | URL that links to the banner photo associated with the company's LinkedIn page |
  | `logo` | text | URL that links to the profile picture of the company's LinkedIn page |
  | `similar` | array | Information about similar companies |
  | `url` | url | The URL or link to the company's LinkedIn page |
  | `updates` | array | Information about the company's most recent posts on LinkedIn |
  | `slogan` | text | The company's slogan |
  | `affiliated` | array | Information about affiliated companies |
  | `funding` | object | Information related to the company's financial backing and investments |
  | `investors` | array | Information about the company's investors |
  | `formatted_locations` | array | Geographical location of the company |
  | `stock_info` | object | Information about the company's stock-related data. Include details such as the stock exchange where the company is listed (e.g., NYSE, NASDAQ) |
  | `get_directions_url` | array | The url of the directions provided by the company on linkedin |
  | `description` | text | raw description in html |
  | `additional_information` | text | Open-roles summary text extracted from LinkedIn |
  | `country_codes_array` | array | array of all relevant countries the company locate in |
  | `alumni` | number | Number of alumni on LinkedIn |
  | `alumni_information` | array | Aggregated alumni insights |
  | `website_simplified` | text | Company website root domain |
  | `unformatted_about` | text | Raw About text captured from the page |
</Accordion>

包含输入 schema 的机器可读版本：[`/scrapers/gd_l1vikfnt1wgvvqz95w.json`](/scrapers/gd_l1vikfnt1wgvvqz95w.json)

## 职位

**数据集 ID：** `gd_lpfll7v5hcqtkxl6l`

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

<Accordion title="示例响应">
  ```json theme={null}
  [
    {
      "job_title": "Software Engineer",
      "company_name": "Epic",
      "job_location": "San Jose, CA",
      "job_seniority_level": "Entry level",
      "job_employment_type": "Full-time",
      "job_industries": "Software Development",
      "job_summary": "Please note that this position is based on our campus in Madison, WI, and requires relocation to the area. We recruit nationally and provide financial reloca...",
      "apply_link": null,
      "is_easy_apply": false,
      "url": "https://www.linkedin.com/jobs/view/3986111804?_l=en"
    }
  ]
  ```
</Accordion>

[完整职位响应模式](/cn/api-reference/scrapers/social-media-apis/linkedin-jobs-collect-by-url)

### LinkedIn 职位抓取器返回哪些输出字段？

LinkedIn 职位抓取器（`gd_lpfll7v5hcqtkxl6l`，`collect_by_url`）返回 27 个输出字段。字段说明保留 API 返回的英文原文。

<Accordion title="输出字段（27）">
  | 字段 | 类型 | 说明 |
  | - | - | - |
  | `url` | url | The job posting's web link on LinkedIn |
  | `job_posting_id` | text | Unique identifier for each job listing |
  | `job_title` | text | Title of the advertised job position |
  | `company_name` | text | Name of the hiring company |
  | `company_id` | text | Unique identifier for each company |
  | `job_location` | text | Geographic location of the job |
  | `job_summary` | text | Brief overview of job responsibilities |
  | `job_seniority_level` | text | Seniority level of the position |
  | `job_function` | text | Specific department or function of the job |
  | `job_employment_type` | text | Type of employment offered |
  | `job_industries` | text | Industries associated with the job |
  | `job_base_pay_range` | text | Salary range for the position |
  | `company_url` | url | LinkedIn profile link of the hiring company |
  | `job_posted_time` | text | Timestamp for when the job was posted |
  | `job_num_applicants` | number | Number of applicants for the job |
  | `discovery_input` | object | Discovery input values |
  | `apply_link` | url | Link or information for job application |
  | `country_code` | country | 2 letter country code |
  | `title_id` | text | standardized LinkedIn job title ID |
  | `company_logo` | image | the logo image of the company posted the job |
  | `job_posted_date` | date | parsed date of the job posting time |
  | `job_poster` | object | Profile of the person who posted the job |
  | `application_availability` | boolean | Whether a user can still apply for this job |
  | `job_description_formatted` | text | The job description as it appears in LinkedIn |
  | `base_salary` | object | Structured base pay range with currency and pay period |
  | `salary_standards` | text | Employer-provided pay standards or notes |
  | `is_easy_apply` | boolean | Does it have easy apply |
</Accordion>

包含输入 schema 的机器可读版本：[`/scrapers/gd_lpfll7v5hcqtkxl6l.json`](/scrapers/gd_lpfll7v5hcqtkxl6l.json)

## 帖子

**数据集 ID：** `gd_lyy3tktm25m4avu764`

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

<Accordion title="示例响应（示意，非实际抓取）">
  ```json theme={null}
  [
    {
      "post_text": "Excited to share our latest AI innovations...",
      "num_likes": 45230,
      "num_comments": 1250,
      "date_posted": "2024-04-03T14:30:00.000Z",
      "hashtags": ["AI", "Innovation"],
      "user_followers": 10842560,
      "post_type": "original"
    }
  ]
  ```
</Accordion>

[完整帖子响应模式](/cn/api-reference/scrapers/social-media-apis/linkedin-posts-collect-by-url)

### LinkedIn 帖子抓取器返回哪些输出字段？

LinkedIn 帖子抓取器（`gd_lyy3tktm25m4avu764`，`collect_by_url`）返回 37 个输出字段。字段说明保留 API 返回的英文原文。

<Accordion title="输出字段（37）">
  | 字段 | 类型 | 说明 |
  | - | - | - |
  | `url` | url | The web link to the individual LinkedIn post |
  | `id` | text | A unique identifier for each LinkedIn post |
  | `user_id` | text | The unique identifier for the user who created the post |
  | `use_url` | url | The web link to the profile of the user who created the post |
  | `title` | text | The title or main subject of the LinkedIn post, if applicable |
  | `headline` | text | A brief headline summarizing the post’s content |
  | `post_text` | text | The main text content of the LinkedIn post |
  | `date_posted` | date | The date and time when the post was published on LinkedIn |
  | `hashtags` | array | Keywords or phrases prefixed with a hash (#) used in the post to tag content |
  | `embedded_links` | array | RLs included within the post that link to external content |
  | `images` | array | Any images attached or embedded in the post |
  | `videos` | array | Any videos attached or embedded in the post |
  | `num_likes` | number | The total number of likes the post has received |
  | `num_comments` | number | The total number of comments the post has received |
  | `more_articles_by_user` | array | Links to other posts or articles written by the same user |
  | `more_relevant_posts` | array | Links to other posts that are relevant or related to the content of this post |
  | `top_visible_comments` | array | Top comments on post, only some comments if any are visible without a login |
  | `user_followers` | number | Number of followers of the user |
  | `user_posts` | number | User number of posts |
  | `user_articles` | number | Number of user articles |
  | `post_type` | text | article/post |
  | `account_type` | text | Author type of the posting account: 'Person' or 'Company |
  | `post_text_html` | text | The post text keeping the line breaks |
  | `repost` | object | Details of the original post that was reshared |
  | `tagged_companies` | array | Companies tagged or mentioned in the post |
  | `tagged_people` | array | People tagged or mentioned in the post |
  | `user_title` | text | The title of the post's author |
  | `author_profile_pic` | url | The post's author profile picture |
  | `num_connections` | number | The number of connections of the post's author |
  | `video_duration` | number | Duration of the post's video |
  | `external_link_data` | array | Preview cards for external links included in the post |
  | `video_thumbnail` | url | Thumbnail image URL for the attached video |
  | `document_cover_image` | url | Cover image URL for an attached document |
  | `document_page_count` | number | Total number of pages in the attached document |
  | `user_profile_pic` | url | The user's profile picture |
  | `user_name` | text | The name if the user posting |
  | `original_post_text` | text | The post's text including line breaks like how it appears on LinkedIn |
</Accordion>

包含输入 schema 的机器可读版本：[`/scrapers/gd_lyy3tktm25m4avu764.json`](/scrapers/gd_lyy3tktm25m4avu764.json)

## 快速参考：数据集 ID

| 端点 | 数据集 ID | URL 模式 |
| :- | :- | :- |
| 个人资料 | `gd_l1viktl72bvl7bjuj0` | `linkedin.com/in/{username}` |
| 公司 | `gd_l1vikfnt1wgvvqz95w` | `linkedin.com/company/{slug}` |
| 职位 | `gd_lpfll7v5hcqtkxl6l` | `linkedin.com/jobs/view/{id}` |
| 帖子 | `gd_lyy3tktm25m4avu764` | `linkedin.com/posts/{slug}` |

## 输出格式

使用 `format` 查询参数控制响应格式：

| 值 | 描述 |
| :- | :- |
| `json` | JSON 数组 |
| `ndjson` | 换行分隔的 JSON，每行一条记录（默认） |
| `csv` | 逗号分隔值 |

以上是 `/scrape` 的 `format` 值。完整列表（NDJSON（默认）、JSON、JSON lines、CSV 和 Parquet）及各格式适用范围见[输出格式](/cn/products/scrapers/scrapers-library/data-delivery#支持哪些输出格式)。

## 相关内容

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

  <Card title="API 参考" icon="code" href="/api-reference/scrapers/social-media-apis/linkedin-profiles-collect-by-url">
    完整的参数和响应字段参考。
  </Card>
</CardGroup>