LinkedIn Profile Posts
LinkedIn 个人主页关联的公开动态可能包含原创帖子、转发、文章、图片、视频、文档和其他公开活动。返回记录是用于内容研究的采集时样本，不代表完整活动历史、私有分析数据或仅连接可见的内容。
主要特性
- 通过个人主页 URL 发现接受一个或多个公开 LinkedIn /in/ URL，并发现与每个已提交主页关联的帖子。
- 可选原创帖子过滤透传 only_authored_posts，让 provider 尝试只保留其判定为目标主页作者发布的帖子。
- Provider 日期窗口透传可选 start_date 和 end_date 字符串用于 provider 过滤，不在本地规定格式、顺序、边界或时区。
- 标准化内容上下文在固定 post schema 中返回可用的正文、作者、发布时间、媒体、标签、提及和来源 URL。
- 可见互动快照将可用点赞数、评论数、分享数和浏览数与 collected_at 一起保留，使指标带有观察时间。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 LinkedIn 个人主页 URL 列表；必须使用 LinkedIn 域名，且路径以 /in/ 开头。 |
start_date | 可选 | 可选的非空 provider 日期过滤字符串，会应用于每个输入主页；SocQ 不解析或验证其格式和包含边界。 |
end_date | 可选 | 可选的非空 provider 日期过滤字符串，会应用于每个输入主页；SocQ 不检查它与 start_date 的先后顺序。 |
only_authored_posts | 可选 | 应用于每个主页的可选布尔值；true 请求 provider 判定的原创帖子，但不构成 SocQ 身份审计。 |
results_limit | 可选 | 可选整数，范围为 1 至 2000，分别应用于每个主页 URL，默认每个主页 100 条。 |
如何使用
提交个人主页 URL 和发现控制项，跟踪异步任务，再分页读取已存储的标准化帖子。
- 准备一个或多个路径以 /in/ 开头的公开 LinkedIn 个人主页 URL。
- 选择 only_authored_posts，并为每个主页设置 1 至 2000 的 results_limit；仅在需要时添加 provider 日期字符串。
- 向 /v1/linkedin/profile-posts 发送 POST，并轮询 /v1/tasks/{task_id} 直到任务成功或失败。
- 读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/linkedin/profile-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/in/satyanadella/"],"only_authored_posts":true,"results_limit":20}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 公开沟通内容审阅： 研究选定职业主页关联帖子中的主题、论点、链接和重复语言。
- 原创内容抽样： 使用 only_authored_posts 请求更窄的样本，并在作者归属重要时检查返回的 author 字段。
- 内容形式与媒体研究： 比较已定义结果集中的图片、视频、文档、文章、标签和提及模式。
- 限定时间的互动快照： 应用 provider 日期字符串，仅在采集样本内比较可见互动，同时保留 published_at 和 collected_at。
使用建议
- 将 results_limit 视为每个主页的上限：5 个 URL、每个上限 20 条时，最多可存储 100 条帖子。
- 把日期输入作为 provider 字符串并自行记录约定，因为 SocQ 不验证格式、顺序、边界或时区。
- only_authored_posts 重要时仍要检查返回作者；该参数请求 provider 过滤，不会证明身份。
- 在互动指标旁保留 collected_at，因为可见计数会随不同运行时间变化。
- 将 null 与零区分，并允许发布时间、指标、媒体、标签或提及为空。
- 不要仅根据标准化样本推断专业能力、雇佣状态、情感、线索质量、影响力或内容效果。
相关 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 Post Comments API — 采集已知 LinkedIn 帖子公开提供的评论，返回正文、作者信息、时间、关系标识以及可见点赞数和回复数。
- LinkedIn Search Jobs API — 通过必填地点和可选筛选搜索 LinkedIn 公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Search People API — 通过 LinkedIn 人员搜索 URL 发现候选公开主页，返回标准化身份、描述、图片、地点、网站、账号信号和可用指标。
- LinkedIn Search Posts API — 通过关键词和可选日期字符串发现 Google 索引的 LinkedIn 公开帖子，返回标准化正文、作者、媒体、标签、时间和可见互动。