Company Employee Count公司员工人数
该接口返回指定上市公司各年度监管报告（如 SEC 10-K 年报）披露的员工总人数序列，并同步附带会计期间截止日、正式申报日期、申报表单类型、CIK 编号及 SEC EDGAR 官方原始年报直链。它是核算人均创收、人均创利与跟踪企业扩招裁员周期的权威数据源。
https://quote-fmp.com/stable/employee-count?symbol=AAPL数据更新周期
1-3 Days
接口说明
- 人均效能因子精确分母：在评估科技、互联网、高端制造或连锁零售企业的经营效率时，“单员工创造的营业收入”与“单员工创造的营业利润”是衡量组织人效与规模效应的核心指标。该接口提供经审计年报披露的精确员工总数，直接作为人效因子的分母输入。
- 精确到年报披露日的时间对齐与合规溯源：接口不仅提供会计财年截止日，还明确给出了年报向 SEC 提交的实际申报日期与 10-K 原文链接。这既保证了量化回测在启用最新员工数据时严格遵循真实信息到达日，也方便研究员一键跳转原始年报核查全职与兼职用工结构说明。
- 捕捉企业扩张周期与降本增效拐点：将各期员工人数变化率与同期营收增速、研发及销售费用率结合分析，可清晰识别企业是处于顺周期产能扩张期，还是在行业寒冬中通过缩减人员规模来保住利润率与自由现金流。
- 跨模块关联接口：Stock Peer Comparison（同业公司对比） · Delisted Companies（退市公司清单） · Stock Screener（条件选股） · Company Profile Data（公司概况）
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS） |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
调用代码示例
Python 关键代码请求 /stable/employee-count 拉取公司员工人数（必填 symbol），可直取 acceptanceTime（受理时间）、periodOfReport（报告期）、companyName（公司名称）（如 acceptanceTime=2025-10-31 06:01:26）共 9 项。
resp = requests.get(
"https://quote-fmp.com/stable/employee-count",
params={"symbol": "AAPL", "limit": 100, "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 按 filingDate 升序重排并数值化 employeeCount（员工人数）
df["employeeCount"] = pd.to_numeric(df["employeeCount"], errors="coerce")
df = df.sort_values("filingDate").reset_index(drop=True)参数使用和避坑
3 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法：
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 单票检索 AAPL 的公司员工人数数据 | symbol=AAPL | 在 /stable/employee-count 中锁定 AAPL，返回 公司员工人数 对应的 acceptanceTime、periodOfReport、companyName 明细列表。 |
| 长窗口拉取 AAPL 多期公司员工人数明细 | symbol=AAPL&limit=100 | 将单次返回上限设为 100 访问 /stable/employee-count，高效同步 AAPL 的 acceptanceTime、periodOfReport、companyName 等 9 项数据。 |
| 非美交易所标的（symbol=0700.HK）查询公司员工人数 | symbol=0700.HK | 向 /stable/employee-count 传带交易所后缀的 symbol=0700.HK，拉取非美标的的 acceptanceTime、periodOfReport、companyName 明细。 |
公司员工人数由 /stable/employee-count 承载（必填 symbol），核心列包括 acceptanceTime（受理时间，样本 2025-10-31 06:01:26）与 periodOfReport；查询非美标的时请确认后缀格式正确。
将公司员工人数（/stable/employee-count）落库时，建议以 (symbol, cik, filingDate) 建联合唯一索引；核心列 employeeCount（员工人数，样本 166000）宜转为 float64 处理。
返回数据
9 个字段本接口示例响应共包含 9 个字段（数值型 1 个，文本/日期/布尔型 8 个）。下表列出全部字段名、类型、首条记录真实样本值与中文释义，实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "AAPL" | 证券代码 |
cik | string | "0000320193" | SEC CIK 编号（SEC 10 位定长中央索引键，落库须定义为 VARCHAR(10) 字符串以防前导零丢失） |
acceptanceTime | string | "2025-10-31 06:01:26" | 受理时间 |
periodOfReport | string | "2025-09-27" | 报告期 |
companyName | string | "Apple Inc." | 公司名称 |
formType | string | "10-K" | SEC 申报表单类型（如 10-K、10-Q、8-K、4、13F） |
filingDate | string | "2025-10-31" | 申报日期（监管申报日期；若同表含 acceptedDate，实盘事件对齐应优先取 acceptedDate） |
employeeCount | number | 166000 | 员工人数 |
source | string | "https://www.sec.gov/Archives/e…" | 数据来源链接（SEC 原文） |
查看响应数据示例（原始 JSON）
[
{
"symbol": "AAPL",
"cik": "0000320193",
"acceptanceTime": "2025-10-31 06:01:26",
"periodOfReport": "2025-09-27",
"companyName": "Apple Inc.",
"formType": "10-K",
"filingDate": "2025-10-31",
"employeeCount": 166000,
"source": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.htm"
}
]常见问题解答（FAQ）
2 个问题员工人数对应哪一个时点，如何与财报对齐？
先看 periodOfReport 所指报告期间，再用 filingDate、acceptanceTime 和 source 核对披露来源。员工人数是该报告口径下的快照，不是逐日人数。跨公司比较前确认期间及员工统计定义；不能把最近一次人数填入所有历史财报日期。
如何确保从 /stable/employee-count 拉取的公司员工人数覆盖完整目标区间且不触发空跑？
为保障采集稳定性，请通过 /stable/employee-count 的 limit 参数控制单次返回的历史期数或记录上限；并针对 /stable/employee-count 返回的 acceptanceTime（如 2025-10-31 06:01:26）建立自动化数据质量断言。
同模块相关接口对比
Employee Count本接口路径 /stable/employee-count，必填参数 symbol。 同一模块「Employee Count」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 历史员工人数Company Historical Employee Count | /stable/historical-employee-count | 按历史报告期时间序列返回指定上市公司自早期以来的历年员工人数演变台账 |