LinkedIn Companies
公开 LinkedIn 公司主页展示公司简介、网站、行业、规模、总部、地点、专长以及公开可见的粉丝数和员工数。这些属性可用于补全客户资料、划分公司类型、绘制市场版图，并比较公司公开信息随时间发生的变化。
主要特性
- 公开公司主页 URL 输入一次处理一个或多个 LinkedIn /company/{slug} URL，不会混入个人主页、帖子或职位链接。
- 公司信息与网站资料在同一条标准化记录中返回公开公司名称、简介、网站、Logo 和 LinkedIn 主页 URL。
- 结构化公司属性将行业、公司规模、总部、成立年份、地点和专长整理为便于筛选和比较的字段。
- 公开粉丝数和员工数将可用的粉丝数和员工数作为独立指标，与公司属性一起返回。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 LinkedIn 公司主页 URL 列表。每个 URL 必须使用 linkedin.com 或 LinkedIn 子域名下的 /company/{slug} 路径。 |
如何使用
提交已经确认的公司主页，等待企业数据处理完成，再逐页读取企业画像。
- 准备路径符合 /company/{slug} 的公开公司主页链接。
- 将链接列表作为 urls 提交到 /v1/linkedin/companies，并保存 task_id。
- 跟踪 /v1/tasks/{task_id}，直到公司数据处理完成或失败。
- 读取 data.results.items；如仍有结果页，则从 next_cursor 继续。
curl -X POST "https://api.socq.ai/v1/linkedin/companies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.linkedin.com/company/microsoft/"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor最佳使用场景
- 客户和 CRM 资料补全： 根据已知公司主页，为现有记录补充简介、网站、Logo、行业、规模和总部。
- 公司分类与细分： 利用行业、公司规模、地点和专长对目标公司进行分组，用于研究或客户规划。
- 市场与地点分析： 结合总部和地点数组，比较选定公司所在或经营的地区。
- 公司公开信息监测： 比较不同时期保存的公司记录，识别简介、地点、专长或公开规模指标的变化。
使用建议
- 提交前统一并按公司 slug 去重，避免同一 /company/ 主页的不同 URL 写法产生重复记录。
- 行业、地点和专长应保留为数组，以免丢失多值企业属性。
- 比较公司属性或公开计数变化时，为每条保存记录保留 collected_at。
相关 API
需要其他类型的 LinkedIn 公开数据时，可以使用以下 API。
- LinkedIn Profiles API — 从个人主页 URL 标准化公开身份、职位、地区、可见受众数量、经历、教育和技能。
- LinkedIn Posts API — 从受支持 URL 采集公开帖子正文、作者、可见互动、媒体、发布时间、类型和标签。
- LinkedIn Jobs API — 标准化公开职位名称、公司、描述、地点、资历、雇佣信息、申请链接和可用薪资字段。