LinkedIn Post Comments
LinkedIn 帖子评论是附着在一个已知帖子下的公开响应；该接口把帖子公开提供的评论整理成独立记录，包含可用的正文、公开作者字段、发布时间与采集时间、来源关系、点赞数和回复数。结果顺序取决于来源；看到回复数不表示结果中包含回复正文。
主要特性
- 以一个已知帖子为边界接受一个受支持的 /posts/、/pulse/ 或 /feed/update/ URL，只检查该帖子公开提供的评论。
- 标准化评论记录在固定 comment schema 中返回评论正文，以及可用的 ID、公开 URL、发布时间、采集时间和公开作者字段。
- 可用的关系上下文来源提供时保留 parent_id 和 post_id；来源未提供时，这些已声明字段保持 null。
- 可见响应计数likes_count 和 replies_count 作为可空指标保留，不会把无法取得的计数转换为零。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填的公开 LinkedIn 帖子 URL，支持 /posts/、/pulse/，以及 /feed/update/urn:li:activity 或 /feed/update/urn:li:share。 |
如何使用
提交一个受支持的公开帖子 URL，跟踪异步任务，再分页读取该完成任务已经存储的评论。
- 选择一个公开 LinkedIn URL，其路径为 /posts/、/pulse/，或带 activity/share URN 的 /feed/update/。
- 将链接作为 url 提交到 /v1/linkedin/post-comments，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 data.results.items；has_more 为 true 时继续使用 next_cursor。该游标只分页读取 SocQ 已存储结果，不会翻页请求 LinkedIn 评论。
curl -X POST "https://api.socq.ai/v1/linkedin/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.linkedin.com/posts/aagupta_what-you-need-to-know-ai-agents-activity-7354600338621906944-RvXR"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 审阅已知帖子的响应： 读取选定公告、文章或活动帖子下的公开评论正文，不扩展为账号级内容发现。
- 问题与反馈分流： 把返回正文交给人工审阅问题、异议或产品反馈，同时保留来源链接和作者上下文。
- 公开互动快照： 比较已返回评论中可用的点赞数和回复数，并用 collected_at 标记观察时间。
- 带来源的评论归档： 将标准化评论与提交的帖子 URL、可用 post_id 或 parent_id 一起保存，便于后续审计与检索。
使用建议
- 重复提交同一帖子不同形式的 URL 前，先按 activity 或 share 标识去重。
- 不要传入 results_limit、排序或回复展开字段；url 是唯一接受的请求属性。
- 将返回顺序视为来源决定，不要假设它稳定地按时间或相关性排序。
- likes_count 和 replies_count 为 null 时要与零区分，因为无法取得计数不等于没有互动。
- 不要仅根据标准化字段推断情感、意图、资历、线索质量或自动化行为。
- next_cursor 只用于读取完成任务已存储的全部评论，不会继续请求 LinkedIn 的下一页评论。
相关 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 Company Posts API — 通过 LinkedIn 公司主页 URL 发现公开帖子，返回正文、作者信息、媒体、话题标签、时间和可见互动指标。
- LinkedIn Profile Posts API — 通过 LinkedIn 个人主页 URL 发现关联的公开帖子，返回作者、媒体、标签、时间和可见互动信息。
- LinkedIn Search Jobs API — 通过必填地点和可选筛选搜索 LinkedIn 公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Search People API — 通过 LinkedIn 人员搜索 URL 发现候选公开主页，返回标准化身份、描述、图片、地点、网站、账号信号和可用指标。
- LinkedIn Search Posts API — 通过关键词和可选日期字符串发现 Google 索引的 LinkedIn 公开帖子，返回标准化正文、作者、媒体、标签、时间和可见互动。