LinkedIn 采集器 API 指南

采集为异步：提交 run → 轮询 → 取数。完整流程见 快速开始；统一响应信封 / run 状态机 / 计费 / 错误码见 认证与错误处理。本页只列各端点的提交目标字段与输出字段。

通用约定

提交体统一为 { "deliveryMode": "async", "recordLimit": 1000, "targets": [ … ] }；targets[] 每个元素的字段见下方各端点「目标字段」表。提交返回 HTTP 201 + { "code": 0, "message": "ok", "data": { "id": <run 号>, "status": "queued" } }，随后按 id 轮询 GET /v1/scraper/runs/{id} 至 succeeded，再 GET /v1/scraper/runs/{id}/records 分页取数。

💡 也可用 deliveryMode: "sync" 同步模式（小任务阻塞等终态，超时自动 fallback 转轮询）——详见 快速开始 · 同步模式。

端点总览：

Profile — 个人主页

按 URL 采集个人主页公开信息（含工作经历、教育背景、技能）。每个 URL 是一个采集目标（target），一个 run 内可批量提交多个。

端点：POST /v1/scraper/linkedin/profile

目标字段（targets[] 每个元素）：

输出字段（records 每条）：

提交示例（一个 run 采集 2 个主页）：

curl -X POST "https://api.antsdata.com/v1/scraper/linkedin/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      { "profileUrl": "https://www.linkedin.com/in/williamhgates/" },
      { "profileUrl": "https://www.linkedin.com/in/satyanadella/" }
    ]
  }'

返回 201 → { "code": 0, "data": { "id": 1287345, "status": "queued" } }。记下 id，轮询 GET /v1/scraper/runs/1287345 至 succeeded，再取记录。

Company — 公司主页

按 URL 采集公司主页公开信息。每个 URL 是一个采集目标（target），一个 run 内可批量提交多个。

端点：POST /v1/scraper/linkedin/company

目标字段（targets[] 每个元素）：

输出字段（records 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/linkedin/company" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      { "companyUrl": "https://www.linkedin.com/company/microsoft/" }
    ]
  }'

返回 201 → { "code": 0, "data": { "id": 1287346, "status": "queued" } }。轮询该 id 至 succeeded 再取记录。

Jobs — 职位搜索

按关键词、地点、经验级别等条件搜索职位列表。一个搜索条件是一个采集目标（target）。

端点：POST /v1/scraper/linkedin/jobs

目标字段（targets[] 每个元素）：

输出字段（records 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/linkedin/jobs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      {
        "keywords": "data engineer",
        "location": "United States",
        "resultsLimit": 100,
        "experienceLevel": "MID_SENIOR",
        "jobType": "FULL_TIME",
        "workplaceType": "REMOTE"
      }
    ]
  }'

返回 201 → { "code": 0, "data": { "id": 1287347, "status": "queued" } }。轮询该 id 至 succeeded 再分页取职位列表。

Posts — 个人主页动态

采集个人主页发布的动态帖子。profileUrls 与 companyUrls 至少一侧非空。

端点：POST /v1/scraper/linkedin/posts

目标字段（targets[] 每个元素）：

输出字段（records 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/linkedin/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      {
        "profileUrls": ["https://www.linkedin.com/in/williamhgates/"],
        "resultsLimit": 25,
        "includeComments": false
      }
    ]
  }'

返回 201 → { "code": 0, "data": { "id": 1287348, "status": "queued" } }。轮询该 id 至 succeeded 再取帖子记录。

Posts by Company — 公司主页动态

采集公司主页发布的动态帖子。以公司主页 URL 为主入口，companyUrls 与 profileUrls 至少一侧非空。

端点：POST /v1/scraper/linkedin/posts-company

目标字段（targets[] 每个元素）：

输出字段（records 每条，同 Posts）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/linkedin/posts-company" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      {
        "companyUrls": ["https://www.linkedin.com/company/microsoft/"],
        "resultsLimit": 25,
        "includeComments": false
      }
    ]
  }'

返回 201 → { "code": 0, "data": { "id": 1287349, "status": "queued" } }。轮询该 id 至 succeeded 再取帖子记录。

取数与轮询

所有端点提交后统一按 run 生命周期取数：

1. 轮询 GET /v1/scraper/runs/{id}（建议退避 1s→2s→5s）至 succeeded / failed（终态）。
2. GET /v1/scraper/runs/{id}/records?page=1&pageSize=20 分页取记录，items[] 即上方「输出字段」。
3. 或 GET /v1/scraper/runs/{id}/download?format=csv 下载整份产物。

端到端示例（含 Python 提交 / 轮询 / 取数）见 快速开始；信封、状态机、计费与错误码见 认证与错误处理。

FAQ

Q: 调用后会直接返回数据吗？

不会。采集是异步的：提交拿 run id，轮询到 succeeded 后按 id 取记录。

Q: 一个 run 能采集多个主页 / 公司吗？

可以。Profile / Company 每个 URL 一个 target，一个 run 可含多个 target；逐目标成败见 run 对象的 tasks[]（详见认证与错误处理）。

Q: 个人动态与公司动态用哪个端点？

采个人主页动态用 /posts（主入口 profileUrls）；采公司主页动态用 /posts-company（主入口 companyUrls）。两端点出参字段一致。

Q: 采集需要登录目标账号吗？

不需要。仅采集公开数据；私密账号无法采集。

下一步

• 平台指南：TikTok · X · Instagram · Facebook · Google · YouTube · Amazon
• 同步搜索：Google SERP
• 认证与错误处理 — 统一响应信封、run 状态机、计费与错误码