LinkedIn Posts API

LinkedIn Posts

主要特性

• 支持多种帖子 URL处理公开 /posts/ 和 /pulse/ 链接，以及包含 activity 或 share 标识的 /feed/update/ URL。
• 正文与作者信息关联将公开帖子正文、来源 URL 和标准化作者信息保存在同一条内容记录中。
• 媒体与发布信息来源提供时，分别返回媒体、发布时间、标题、headline、帖子类型和标签，不将这些字段混入正文。
• 可见互动指标将可用的点赞数、评论数和转发数作为独立指标写入每条帖子记录。

参数

如何使用

指定需要留存的帖子链接，跟踪内容处理状态，再读取结构化帖子结果。

1. 检查每条公开链接是否使用 /posts/、/pulse/ 或受支持的 /feed/update/ URN。
2. 把链接作为 urls 提交至 /v1/linkedin/posts，并记录 task_id。
3. 查看 /v1/tasks/{task_id}，直到帖子处理成功或返回失败。
4. 先读取 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