LinkedIn Posts
一条公开 LinkedIn 帖子包含作者发布的正文、媒体、发布信息、标签、内容类型以及可见的点赞数、评论数和转发数。这些信息可用于归档内容、研究主题与内容形式，并比较选定帖子的公开互动表现。
主要特性
- 支持多种帖子 URL处理公开 /posts/ 和 /pulse/ 链接，以及包含 activity 或 share 标识的 /feed/update/ URL。
- 正文与作者信息关联将公开帖子正文、来源 URL 和标准化作者信息保存在同一条内容记录中。
- 媒体与发布信息来源提供时，分别返回媒体、发布时间、标题、headline、帖子类型和标签，不将这些字段混入正文。
- 可见互动指标将可用的点赞数、评论数和转发数作为独立指标写入每条帖子记录。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 LinkedIn 帖子 URL 列表，支持 /posts/、/pulse/，以及包含 activity 或 share 标识的受支持 /feed/update/ 路径。 |
如何使用
指定需要留存的帖子链接，跟踪内容处理状态，再读取结构化帖子结果。
- 检查每条公开链接是否使用 /posts/、/pulse/ 或受支持的 /feed/update/ URN。
- 把链接作为 urls 提交至 /v1/linkedin/posts，并记录 task_id。
- 查看 /v1/tasks/{task_id}，直到帖子处理成功或返回失败。
- 先读取 data.results.items；has_more 仍为 true 时，传入 next_cursor 获取后续页面。
curl -X POST "https://api.socq.ai/v1/linkedin/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/posts/microsoft_were-more-than-a-single-story-at-microsoft-activity-7401349457478569985-pp34"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor最佳使用场景
- 活动内容归档： 为一组明确的活动帖子保存正文、作者、媒体、发布时间和来源 URL。
- 主题与信息研究： 结合帖子正文、headline 和标签，比较选定 LinkedIn 内容中的主题。
- 内容形式分析： 利用 post_type 和媒体字段，比较选定内容中呈现的帖子形式。
- 公开互动比较： 对比一组选定帖子的公开点赞数、评论数和转发数。
使用建议
- 下游记录需要追溯输入来源时，同时保存提交 URL 和结果中的 url。
- 处理一组帖子链接前，应按 activity 或 share 标识去重，不要只比较完整 URL 字符串。
- 将媒体、标签、标题、headline 和帖子类型视为可选字段，因为并非每条公开帖子都会提供。
- 为可见互动指标保留 collected_at，因为同一帖子在后续任务中可能显示不同计数。
- 在下游应用中把帖子正文渲染为 HTML 前，应先进行转义或清理。
相关 API
需要其他类型的 LinkedIn 公开数据时，可以使用以下 API。
- LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
- LinkedIn Companies API — 标准化公开公司简介、网站、Logo、可见粉丝和员工数量、行业、地点和专长。
- LinkedIn Jobs API — 标准化公开职位名称、公司、描述、地点、资历、雇佣信息、申请链接和可用薪资字段。
- LinkedIn Company Jobs API — 通过准备好的 LinkedIn /jobs/ URL 发现公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Company Posts API — 通过 LinkedIn 公司主页 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 公开帖子，返回标准化正文、作者、媒体、标签、时间和可见互动。