LinkedIn Search Posts
LinkedIn Search Posts 使用上游 Google 索引发现方式为一个关键词查询查找公开页面，然后提取可用帖子记录。结果是带排名的采集时样本，并非 LinkedIn 个性化原生搜索或完整档案，因此不能解释为全部讨论量、触达、情感或声量份额。
主要特性
- 关键词驱动发现使用一个必填非空主题、组织、产品、人物或短语查询搜索公开索引的 LinkedIn 页面。
- 可选相对日期把 date_posted 字符串透传给 provider；文档值包括 last-hour、last-day、last-week、last-month 和 last-year。
- 与分页对齐的上限以 10 的倍数把 results_limit 设为 10 至 2000；默认值为 10，接受的值不保证 provider 覆盖。
- 规范化帖子记录以稳定字段返回正文、作者、指标、媒体、标签、提及、发布时间和采集时间。
- 识别 cursor 的采集沿 provider cursor 继续请求，直到达到上限、最终或空页面、缺失 cursor 或重复 cursor。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 用于公开索引帖子发现的必填非空关键词或短语。 |
date_posted | 可选 | 透传给 provider 的可选非空相对日期字符串。SocQ 不会独立强制 provider 文档值。 |
results_limit | 可选 | 可选整数结果上限。默认值为 10，接受 10 至 2000，并且必须是 provider 每页 10 条的倍数。 |
如何使用
提交一个关键词查询，轮询异步任务，然后审阅返回的发现样本。
- 选择一个非空 query，并按需选择 provider 相对日期字符串。
- 把 query、date_posted 和 10 条增量提交到 /v1/linkedin/search-posts，然后保存 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务进入终止状态。
- 成功后处理 data.results.items；has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/linkedin/search-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"AI agents","date_posted":"last-week","results_limit":10}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 话题发现： 查找提及所选主题、产品、组织、人物或短语的公开索引帖子。
- 信息与格式审阅： 检查返回的观点、标签、作者、链接和媒体格式，同时不把样本当作完整数据。
- 作者与 URL 筛选： 识别适合人工跟进或按作者采集的公开作者和帖子 URL。
- 讨论采集交接： 选择相关结果 URL，并在需要公开讨论记录时交给 LinkedIn Post Comments。
使用建议
- 比较发现样本时，使用相同 query、日期字符串、结果上限和采集计划。
- 把上游顺序视为搜索排名，而不是中立的热度、时效或相关性分数。
- 不要把成功空结果解释为不存在匹配 LinkedIn 帖子的证明。
- 重要正文和媒体应在来源帖子核实，因为索引页面可能过期、截断、删除或受限。
- 把缺失互动值视为未知而不是零，并为每个快照保留 collected_at。
- 目标发布者已知时，使用 company-posts 或 profile-posts。
相关 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 Profile Posts API — 通过 LinkedIn 个人主页 URL 发现关联的公开帖子，返回作者、媒体、标签、时间和可见互动信息。
- LinkedIn Search Jobs API — 通过必填地点和可选筛选搜索 LinkedIn 公开职位，返回标准化岗位、公司、地点、雇佣、经验、远程、薪资和时间字段。
- LinkedIn Search People API — 通过 LinkedIn 人员搜索 URL 发现候选公开主页，返回标准化身份、描述、图片、地点、网站、账号信号和可用指标。