Company Historical Employee Count历史员工人数
该接口按历史报告期时间序列返回指定上市公司自早期以来的历年员工人数演变台账（含报告期、申报日期、员工总数及 SEC 原始文件链接）。专注于呈现企业跨经济周期的组织规模扩张与收缩轨迹，支撑长周期企业成长阶段划分与人力资本效率回测。
https://quote-fmp.com/stable/historical-employee-count?symbol=AAPL数据更新周期
Filing Date · 随 SEC 申报日期更新
接口说明
- 长周期企业组织规模扩张斜率刻画：通过拉取一家公司横跨十余年的历史员工人数序列，投研人员可直观描绘其从数百人的初创成长期跃升为数万乃至数十万人跨国巨头的组织膨胀曲线，评估其业务增长对人力堆叠的依赖程度（轻资产还是劳动密集型）。
- 验证行业裁员潮与组织精简真实幅度：当市场热议某科技巨头或周期行业启动大规模组织架构精简时，对比该接口中连续多个财年的员工存量净增减绝对值，可客观核验管理层降本增效承诺在法定年报层面的真实落地幅度。
- 构建长窗口人力资本增速量化因子：实证金融研究表明，企业员工规模的异常高速扩张或温和稳健增长往往蕴含着管理层对未来订单景气度的内部预期。该长序列历史接口为构建跨年度用工增速因子提供了完整的时间序列底座。
- 关联数据线接口：All Shares Float（全市场流通股数据） · Latest Mergers & Acquisitions（最新并购） · Stock Quote（股票报价） · Income Statement（利润表）
请求参数
2 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
symbol | string | 必填 | AAPL | 证券代码，例如 AAPL 或 MSFT（美股直传代码如 AAPL；港股/英股/A股须带交易所后缀，如 0700.HK、600519.SS） |
limit | number | 可选 | 100 | 返回结果条数上限，用于控制单次响应大小。 |
调用代码示例
Python 关键代码针对历史员工人数，向 /stable/historical-employee-count 传入必填 symbol后，响应提供 acceptanceTime（受理时间）、periodOfReport（报告期）、companyName（公司名称）（样本 acceptanceTime=2025-10-31 06:01:26）。
resp = requests.get(
"https://quote-fmp.com/stable/historical-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 | 通过 symbol=AAPL 访问 /stable/historical-employee-count，一次拿齐 历史员工人数 的 acceptanceTime、periodOfReport、companyName 等核心列。 |
| 长窗口拉取 AAPL 多期历史员工人数明细 | symbol=AAPL&limit=100 | 将单次返回上限设为 100 访问 /stable/historical-employee-count，高效同步 AAPL 的 acceptanceTime、periodOfReport、companyName 等 9 项数据。 |
| 带 .HK 后缀查询港股标的历史员工人数 | symbol=0700.HK | 针对非美股标的传入 0700.HK，从 /stable/historical-employee-count 提取对应的 acceptanceTime、periodOfReport、companyName。 |
历史员工人数端点 /stable/historical-employee-count（必填 symbol）单次返回 acceptanceTime、periodOfReport、companyName 等 9 项属性；若带日期窗口查询，请确保起止日期为有效交易日。
在本地数据仓库归档历史员工人数时，以 (symbol, cik, filingDate) 去重可防止重跑产生脏数据；其中 employeeCount（员工人数，如 166000）为原始未缩写数值。
返回数据
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 个问题想拉取「Employee Count」相关数据，应该调历史员工人数（/stable/historical-employee-count）还是 公司员工人数？
历史员工人数 对应路径 /stable/historical-employee-count（必填 symbol），涵盖 acceptanceTime（2025-10-31 06:01:26）、periodOfReport（2025-09-27）等 9 列；Company Employee Count（公司员工人数） 对应 /stable/employee-count（必填 symbol，共 9 列）。
如何基于 /stable/historical-employee-count 构建稳定的历史员工人数定时采集与历史补数任务？
回填或同步 历史员工人数 时，请根据回测跨度需求在 /stable/historical-employee-count 中设置 limit 条数上限一次拿齐序列；对返回的 acceptanceTime（受理时间）序列，建议先做排序核对再参与计算。
同模块相关接口对比
Employee Count本接口路径 /stable/historical-employee-count，必填参数 symbol。 同一模块「Employee Count」下共 2 个接口，下表列出其余 1 个， 按粒度与查询维度对比，避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 公司员工人数Company Employee Count | /stable/employee-count | 指定上市公司各年度监管报告披露的员工总人数序列 |