linkedin/
profile-posts

通过 LinkedIn 个人主页 URL 发现关联的公开帖子,返回标准化正文、作者信息、媒体、标签、时间和可见互动。

LinkedIn Profile Posts API

主页 URL 发现
原创帖子过滤
按主页设置上限
每条结果 1 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

LinkedIn Profile Posts

LinkedIn 个人主页关联的公开动态可能包含原创帖子、转发、文章、图片、视频、文档和其他公开活动。返回记录是用于内容研究的采集时样本,不代表完整活动历史、私有分析数据或仅连接可见的内容。

LinkedIn Profile Posts API 主要特性

  • 通过个人主页 URL 发现接受一个或多个公开 LinkedIn /in/ URL,并发现与每个已提交主页关联的帖子。
  • 可选原创帖子过滤透传 only_authored_posts,让 provider 尝试只保留其判定为目标主页作者发布的帖子。
  • Provider 日期窗口透传可选 start_date 和 end_date 字符串用于 provider 过滤,不在本地规定格式、顺序、边界或时区。
  • 标准化内容上下文在固定 post schema 中返回可用的正文、作者、发布时间、媒体、标签、提及和来源 URL。
  • 可见互动快照将可用点赞数、评论数、分享数和浏览数与 collected_at 一起保留,使指标带有观察时间。

LinkedIn Profile Posts API 参数

参数必填描述
urls必填必填的公开 LinkedIn 个人主页 URL 列表;必须使用 LinkedIn 域名,且路径以 /in/ 开头。
start_date可选可选的非空 provider 日期过滤字符串,会应用于每个输入主页;SocQ 不解析或验证其格式和包含边界。
end_date可选可选的非空 provider 日期过滤字符串,会应用于每个输入主页;SocQ 不检查它与 start_date 的先后顺序。
only_authored_posts可选应用于每个主页的可选布尔值;true 请求 provider 判定的原创帖子,但不构成 SocQ 身份审计。
results_limit可选可选整数,范围为 1 至 2000,分别应用于每个主页 URL,默认每个主页 100 条。

如何使用 LinkedIn Profile Posts API

提交个人主页 URL 和发现控制项,跟踪异步任务,再分页读取已存储的标准化帖子。

  1. 准备一个或多个路径以 /in/ 开头的公开 LinkedIn 个人主页 URL。
  2. 选择 only_authored_posts,并为每个主页设置 1 至 2000 的 results_limit;仅在需要时添加 provider 日期字符串。
  3. 向 /v1/linkedin/profile-posts 发送 POST,并轮询 /v1/tasks/{task_id} 直到任务成功或失败。
  4. 读取 data.results.items;has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items;has_more 为 true 时继续使用 next_cursor

LinkedIn Profile Posts API 最佳使用场景

  • 公开沟通内容审阅: 研究选定职业主页关联帖子中的主题、论点、链接和重复语言。
  • 原创内容抽样: 使用 only_authored_posts 请求更窄的样本,并在作者归属重要时检查返回的 author 字段。
  • 内容形式与媒体研究: 比较已定义结果集中的图片、视频、文档、文章、标签和提及模式。
  • 限定时间的互动快照: 应用 provider 日期字符串,仅在采集样本内比较可见互动,同时保留 published_at 和 collected_at。

LinkedIn Profile Posts API 使用建议

  • 将 results_limit 视为每个主页的上限:5 个 URL、每个上限 20 条时,最多可存储 100 条帖子。
  • 把日期输入作为 provider 字符串并自行记录约定,因为 SocQ 不验证格式、顺序、边界或时区。
  • only_authored_posts 重要时仍要检查返回作者;该参数请求 provider 过滤,不会证明身份。
  • 在互动指标旁保留 collected_at,因为可见计数会随不同运行时间变化。
  • 将 null 与零区分,并允许发布时间、指标、媒体、标签或提及为空。
  • 不要仅根据标准化样本推断专业能力、雇佣状态、情感、线索质量、影响力或内容效果。

除了 LinkedIn Profile Posts API,需要其他类型的 LinkedIn 公开数据时,可以使用以下 API。

  • LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
  • LinkedIn Companies API — 标准化公开公司简介、网站、Logo、可见粉丝和员工数量、行业、地点和专长。
  • LinkedIn Posts API — 从受支持 URL 采集公开帖子正文、作者、可见互动、媒体、发布时间、类型和标签。
  • LinkedIn Company Posts API — 通过 LinkedIn 公司主页 URL 发现公开帖子,返回正文、作者信息、媒体、话题标签、时间和可见互动指标。
  • LinkedIn Post Comments API — 采集已知 LinkedIn 帖子公开提供的评论,返回正文、作者信息、时间、关系标识以及可见点赞数和回复数。
  • LinkedIn Video Transcript API — 通过帖子链接把 LinkedIn 视频自带的字幕转成纯文本。

探索其他平台

还可以将 LinkedIn 数据与其他已支持社交平台的公开数据结合使用。

LinkedIn Profile Posts API — 常见问题

LinkedIn Profile Posts API 是一个用于通过已提交 LinkedIn 个人主页 URL 发现关联公开帖子,并返回标准化内容、作者信息、媒体、时间和可见互动的 API。

可以提交一个或多个 linkedin.com 或 LinkedIn 子域名上的 http/https URL,路径必须以 /in/ 开头;公司主页和帖子 URL 不属于该接口输入。

值为 true 时,会透传该参数,请求 provider 只保留其判定为目标主页作者发布的帖子。它不是独立的 SocQ 身份审计,作者归属重要时仍应检查返回 author。

不会。SocQ 会透传非空字符串,但不解析格式、不比较先后顺序,也不定义包含边界和时区;过滤行为由 provider 控制。

不是。它默认 100,支持 1 至 2000,并分别应用于每个 URL,因此任务总量可能等于每个主页上限乘以主页数量。

不是。它只表示本次运行没有为已提交主页和过滤条件获得可用公开帖子;可见性和 provider 状态都会影响覆盖。

每条成功存储的帖子消耗 1 个 SocQ 积分,不收取基础费用。估算按每个主页的结果上限计算,最终按实际存储结果数计费;结果为空时不收取结果费用。