linkedin/
company-posts

通过 LinkedIn 公司主页 URL 发现公开帖子,返回标准化正文、作者信息、媒体、话题标签、发布时间和可见互动指标。

LinkedIn Company Posts API

公司主页发现
可选日期值
公开帖子记录
每条结果 1 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

LinkedIn Company Posts

LinkedIn 公司帖子是围绕组织主页公开展示的动态,包含正文、发布者身份、媒体、发布时间、主题信息和可见互动。利用这些记录可以监测公开沟通、审核内容与媒体,并在选定组织和时间范围之间进行比较。

LinkedIn Company Posts API 主要特性

  • 以公司主页为发现入口使用一个或多个公开 LinkedIn /company/ URL,发现与每个选定组织主页相关的帖子。
  • 区分发布者身份返回标准化 author 对象,避免把公司主页关联关系直接当成单条帖子的发布者身份。
  • 正文与媒体信号在每条记录中组合帖子正文、所附媒体、话题标签、提及、发布时间和原帖 URL。
  • 可见互动快照提供可获得的点赞、评论、分享和观看数量,并把它们作为采集时的计数,而不是推断触达或业务成果。
  • 可选的来源日期值把非空 start_date 和 end_date 字符串随每个输入 URL 转交,不在本地规定格式、先后顺序、区间边界或时区含义。

LinkedIn Company Posts API 参数

参数必填描述
urls必填必填的公开 LinkedIn http 或 https 公司主页 URL 列表。每个域名必须是 linkedin.com 或其子域名,且路径必须以 /company/ 开头。
start_date可选随每个 URL 转交的可选非空来源日期值。公开文档以 YYYY-MM-DD 为例,但服务不会解析格式、区间边界或时区。
end_date可选随每个 URL 转交的可选非空来源日期值。服务不会校验格式,也不要求它晚于 start_date。
results_limit可选分别应用于每个输入 URL 的可选整数上限。默认值为 100,最小值为 1,最大值为 2000。

如何使用 LinkedIn Company Posts API

提交公司主页 URL 和可选日期值,轮询异步任务,然后读取每一页 cursor 结果。

  1. 准备路径以 /company/ 开头的公开 LinkedIn URL。
  2. 把 urls、可选 start_date 与 end_date 字符串以及 results_limit 提交到 /v1/linkedin/company-posts,并保存 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务进入 succeeded 或 failed 状态。
  4. 读取 data.results.items;has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/linkedin/company-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.linkedin.com/company/microsoft/"],"start_date":"2026-01-01","end_date":"2026-06-30","results_limit":20}'

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

LinkedIn Company Posts API 最佳使用场景

  • 公开沟通时间线: 把帖子正文、发布时间、来源 URL 和发布者身份整理成可审核的选定公司主页时间线。
  • 主题与媒体审核: 结合话题标签、提及、正文和媒体引用,检查返回样本中反复出现的公开主题与内容形式。
  • 可比互动快照: 在日期、上限和采集时间保持一致时,对比返回帖子的可见点赞、评论、分享和观看数量。
  • 后续内容筛选: 根据帖子 ID、URL、作者、正文和计数,挑选需要继续分析评论或创意的具体记录。

LinkedIn Company Posts API 使用建议

  • 提交多个主页前,先确认每个输入都是完整的 LinkedIn /company/ URL。
  • 把 start_date 和 end_date 当作由来源解释的字符串;保持使用 YYYY-MM-DD,但不要假定本地校验、区间边界或顺序。
  • 比较多个公司主页时,保持日期、results_limit 和采集时点一致。
  • 逐条检查 author 和帖子 URL,因为与公司主页关联并不保证帖子由该公司主页直接发布。
  • 当重叠主页或重复任务返回同一帖子时,使用稳定的帖子 id 或 URL 去重。
  • 以可失效资源的方式保存媒体链接,因为公开资源可能在采集后跳转、过期或无法访问。

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

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

探索其他平台

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

LinkedIn Company Posts API — 常见问题

LinkedIn Company Posts API 是一个用于从 LinkedIn /company/ 页面 URL 发现公开帖子的 API。它返回标准化正文、作者身份、媒体、话题标签、提及、发布时间和可见互动指标。

每个值都必须是 linkedin.com 或 LinkedIn 子域名上的完整 http 或 https URL,且路径以 /company/ 开头。个人 /in/ 主页和单条帖子 URL 无法通过该接口的 URL 校验。

非空 start_date 和 end_date 字符串会随每个 URL 转交给发现来源。服务不会解析格式、检查先后顺序,也不定义区间边界和时区行为,因此应一致使用 YYYY-MM-DD,并谨慎解释结果。

不一定。结果与提交的公司主页发现信息流相关,但标准化 author 可能指向个人、公司或其他发布者;判断作者时应同时检查 author 和 url。

results_limit 分别应用于每个公司 URL,可填写 1 至 2000 的整数。例如,三个 URL 的上限均为 20 时最多可存储 60 条帖子,实际数量仍取决于公开可见性和来源行为。

它表示本次任务在该 URL 和日期输入下没有返回受支持的公开帖子,并不能证明该组织从未发布内容。空结果还应与无效输入或任务失败区分。

每条返回帖子消耗 1 个 SocQ 积分,不收取基础费用。空结果集不收取结果费用,允许时实际用量可能超过估算。