LinkedIn Company Posts
LinkedIn 公司帖子是围绕组织主页公开展示的动态，包含正文、发布者身份、媒体、发布时间、主题信息和可见互动。利用这些记录可以监测公开沟通、审核内容与媒体，并在选定组织和时间范围之间进行比较。
主要特性
- 以公司主页为发现入口使用一个或多个公开 LinkedIn /company/ URL，发现与每个选定组织主页相关的帖子。
- 区分发布者身份返回标准化 author 对象，避免把公司主页关联关系直接当成单条帖子的发布者身份。
- 正文与媒体信号在每条记录中组合帖子正文、所附媒体、话题标签、提及、发布时间和原帖 URL。
- 可见互动快照提供可获得的点赞、评论、分享和观看数量，并把它们作为采集时的计数，而不是推断触达或业务成果。
- 可选的来源日期值把非空 start_date 和 end_date 字符串随每个输入 URL 转交，不在本地规定格式、先后顺序、区间边界或时区含义。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
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。 |
如何使用
提交公司主页 URL 和可选日期值，轮询异步任务，然后读取每一页 cursor 结果。
- 准备路径以 /company/ 开头的公开 LinkedIn URL。
- 把 urls、可选 start_date 与 end_date 字符串以及 results_limit 提交到 /v1/linkedin/company-posts，并保存 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务进入 succeeded 或 failed 状态。
- 读取 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最佳使用场景
- 公开沟通时间线： 把帖子正文、发布时间、来源 URL 和发布者身份整理成可审核的选定公司主页时间线。
- 主题与媒体审核： 结合话题标签、提及、正文和媒体引用，检查返回样本中反复出现的公开主题与内容形式。
- 可比互动快照： 在日期、上限和采集时间保持一致时，对比返回帖子的可见点赞、评论、分享和观看数量。
- 后续内容筛选： 根据帖子 ID、URL、作者、正文和计数，挑选需要继续分析评论或创意的具体记录。
使用建议
- 提交多个主页前，先确认每个输入都是完整的 LinkedIn /company/ URL。
- 把 start_date 和 end_date 当作由来源解释的字符串；保持使用 YYYY-MM-DD，但不要假定本地校验、区间边界或顺序。
- 比较多个公司主页时，保持日期、results_limit 和采集时点一致。
- 逐条检查 author 和帖子 URL，因为与公司主页关联并不保证帖子由该公司主页直接发布。
- 当重叠主页或重复任务返回同一帖子时，使用稳定的帖子 id 或 URL 去重。
- 以可失效资源的方式保存媒体链接，因为公开资源可能在采集后跳转、过期或无法访问。
相关 API
需要其他类型的 LinkedIn 公开数据时，可以使用以下 API。
- LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
- LinkedIn Companies API — 标准化公开公司简介、网站、Logo、可见粉丝和员工数量、行业、地点和专长。
- LinkedIn Posts API — 从受支持 URL 采集公开帖子正文、作者、可见互动、媒体、发布时间、类型和标签。
- LinkedIn Jobs API — 标准化公开职位名称、公司、描述、地点、资历、雇佣信息、申请链接和可用薪资字段。
- LinkedIn Company Jobs API — 通过准备好的 LinkedIn /jobs/ URL 发现公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Post Comments API — 采集已知 LinkedIn 帖子公开提供的评论，返回正文、作者信息、时间、关系标识以及可见点赞数和回复数。
- LinkedIn Profile Posts API — 通过 LinkedIn 个人主页 URL 发现关联的公开帖子，返回作者、媒体、标签、时间和可见互动信息。
- LinkedIn Search Jobs API — 通过必填地点和可选筛选搜索 LinkedIn 公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Search People API — 通过 LinkedIn 人员搜索 URL 发现候选公开主页，返回标准化身份、描述、图片、地点、网站、账号信号和可用指标。
- LinkedIn Search Posts API — 通过关键词和可选日期字符串发现 Google 索引的 LinkedIn 公开帖子，返回标准化正文、作者、媒体、标签、时间和可见互动。