LinkedIn公司主页 API

POST

接口健康状态

24h 健康值
正常
24h 平均耗时
—
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

公司主页:返回单个对象;主要字段 id、name、universal_name、url、description、tagline。

单价 $0.56 / 千次(每次 $0.000556),失败与空结果不扣费。 同步返回;慢任务可在请求体加 "mode": "async",先拿 job_id 再轮询。

AI 提示词

复制下面这段给你常用的 AI 助手:里面写好了这个接口的参数、返回字段和示例请求,它会先问清你的需求,再帮你写采集脚本。

请帮我用 EveryInfra 的「LinkedIn 公司主页」接口(linkedin/company_profile)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 linkedin,action 填 company_profile,参数放在 params 里。
- 必填参数:
  - company:company_profile/ employees 的 LinkedIn 公司短名或 /company/ 主页 URL;不是任意工商公司名称。
- 可选参数:
  - identifier:company_profile 的公司标识兼容输入,可用公司短名或公司主页链接;company 优先且仍为公开必填。不是个人 /in/ 用户名。
  - name:兼容定位输入:company_profile 中承载公司标识,部分 person_profile 查询中作为人物检索词。它不能代替必填 company/username,也不保证按显示名称精确匹配到同一人。
- 返回一个对象,主要字段:id、name、universal_name(公司在 LinkedIn 的 UR…)、url、description、tagline(公司标语)、website、industries(所属行业)、specialties(公司专长领域)、employee_count(员工数)、employee_count_range(LinkedIn 官方展示的员工数…)、student_count(LinkedIn 上标记为该公司学…);一共 27 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=linkedin。
- 示例请求体:
{
  "platform": "linkedin",
  "action": "company_profile",
  "params": {
    "company": "google"
  }
}
- 计费:$0.56 / 千次;失败和空结果不扣费。
- 一次要采几十上百个时,在请求体加 "mode": "async":先拿到 job_id,再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

写代码前,先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式,再把方案和大概花费讲给我确认。

请求参数

参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是linkedin平台标识,固定值。
actionbodystring是company_profile能力标识,固定值。
companybody.params未声明是-company_profile/ employees 的 LinkedIn 公司短名或 /company/ 主页 URL;不是任意工商公司名称。employees 会将短名补成公司主页,返回公开员工样本,不保证完整在职名单。
identifierbody.params未声明否-company_profile 的公司标识兼容输入,可用公司短名或公司主页链接;company 优先且仍为公开必填。不是个人 /in/ 用户名。
namebody.params未声明否-兼容定位输入:company_profile 中承载公司标识,部分 person_profile 查询中作为人物检索词。它不能代替必填 company/username,也不保证按显示名称精确匹配到同一人。

代码示例

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "linkedin",
  "action": "company_profile",
  "params": {
    "company": "google"
  }
}'

[OpenAPI 定义 (JSON)]示例从环境变量 EVERYINFRA_API_KEY 读取 Key,复制出去的代码不含你的 Key。

响应示例

真实返回样例

2026年9月26日 16:56(北京时间)用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回,已隐去名字、账号、头像、主页链接、联系方式等个人信息;id、billing、quota 每次调用都不同,只给结构。

json
{
  "id": "req_…",
  "platform": "linkedin",
  "action": "company_profile",
  "results": {
    "id": "1441",
    "name": "Google",
    "universal_name": "google",
    "url": "https://www.linkedin.com/company/google/",
    "description": "A problem isn't truly solved until it's solved for all. Googlers build products that help create opportunities for everyone, whether down the street or across the globe. Bring your insight, imagination and a healthy disregard for the impossible. Bring everything that makes you un…",
    "website": "https://goo.gle/3DLEokh",
    "industries": [
      "Software Development"
    ],
    "specialties": [
      "search",
      "ads",
      "mobile"
    ],
    "employee_count": 296456,
    "follower_count": 42415044,
    "is_verified": true,
    "headquarters": "Mountain View, CA, US",
    "logo_url": "https://media.licdn.com/dms/image/v2/D4E0BAQGv3cqOuUMY7g/company-logo_400_400/B4EZmhegXHGcAc-/0/1759350753990/google_logo?e=1792022400&v=beta&t=kKeMovdmLLWhuwM7rpcoIEdKCX0BbQa1JB_C13v0iW0",
    "platform": "linkedin"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

返回字段

业务数据在 results 里;下表是每条记录可能包含的字段,平台没有提供的值不会被补造。

字段含义
id该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
name名称。用于账号/商品/商家类能力,指该对象本身的名字。
universal_name公司在 LinkedIn 的 URL 短名。
url该记录在原平台上的可访问链接。
description简介或描述,通常比 text 短。
tagline公司标语。
website账号或商家填写的外链网址。
industries所属行业。
specialties公司专长领域。
employee_count员工数。
employee_count_rangeLinkedIn 官方展示的员工数区间(如 10001+),比 employee_count 更稳定。
student_countLinkedIn 上标记为该公司学生的账号数;无即为 null。
follower_count粉丝数。null 表示不公开,不等于 0。
founded_year成立年份。
is_verified是否为平台认证账号(蓝V等)。null 表示无法判定。
headquarters总部所在地。
phone联系电话,原文透传,未做号码格式归一。
logo_urllogo 链接。
cover_url公司主页背景大图链接。
hashtags公司/帖子的话题标签列表。
job_search_url该公司在 LinkedIn 的招聘搜索链接。
crunchbase_url公司 Crunchbase 主页链接(融资信息源)。
total_funding_roundsCrunchbase 收录的融资轮次总数;无记录即为 null。
latest_funding_round最近一轮融资:类型、日期、链接与投资方数量;无记录时不返回。
parent_company母公司名称;独立公司不返回。
acquirer_company收购方名称;未被收购不返回。
offices办公地点列表:每项含城市、州/省、国家、街道地址、是否总部与所在大区 region。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

错误与计费

401
缺少 Key 或 Key 无效。先鉴权再校验参数,未鉴权的请求拿不到参数结构。
422
参数名或取值不对。错误信息会列出这项能力支持的参数、允许值和最接近的候选,按它改即可;发生在扣费之前。
402
余额不足,请先充值。
429
超过账户的每分钟请求上限(名下所有 Key 合计;Key 自设了更低上限时先按它算),按 Retry-After 等待后再试。需要更高上限可在控制台买提速包。
503
暂时无法完成。已预扣的费用按原账本退回;响应里的 billing 与 refund 写明实际结果,结果未知时会明确标出,不要直接重发。
200 空结果
请求完成但没有数据,不扣费(billing.reason = empty_result_refunded)。