SEC Filings By Name按名称查 SEC 申报
该接口按公司名称或申报实体英文关键词模糊检索 SEC EDGAR 申报记录,快速反查目标主体的 10 位 CIK 编码、股票代码与申报归档链接。
https://quote-fmp.com/stable/sec-filings-company-search/name?company=Berkshire数据更新周期
N/A · 不适用固定周期
接口说明
- 按实体检索:通过名称查找公司、公募基金及其他实体的 SEC 申报,传入
company后可呈现name(名称)、sicCode(SIC行业代码)与industryTitle(行业分类名称) 等核心指标,辅助买方研究员快速核验标的基本面。 - 全面申报访问:获取 8-K、10-K、10-Q 等关键表格,可查看特定公司的申报,基于
sicCode(SIC行业代码)与industryTitle(行业分类名称) 等核心指标,省去多源报表口径折算与人工核对环节。 - 公司信息:除 SEC 申报外,还提供 CIK 编号、营业地址与联系方式等额外信息,在搭建投研工作流时,建议配合「按 CIK 查 SEC 申报」同步拉取关联截面数据。
- 跨模块关联接口:All Industry Classification(全行业分类数据) · Latest 8-K SEC Filings(最新8-K申报文件) · Equity Offering Updates(最新股权发行) · Financial Reports Form 10-K JSON(10-K年报数据(JSON))
请求参数
1 个参数| 参数 | 类型 | 要求 | 示例 | 说明 |
|---|---|---|---|---|
company | string | 必填 | Berkshire | 公司或机构名称关键词,用于按公司名检索 SEC 申报文件。 |
调用代码示例
Python 关键代码按名称查 SEC 申报由 /stable/sec-filings-company-search/name 提供(必填 company),明细涵盖 name(名称)、sicCode(SIC 行业代码)、industryTitle(行业分类名称) 等 7 列。
resp = requests.get(
"https://quote-fmp.com/stable/sec-filings-company-search/name",
params={"company": "Berkshire", "apikey": FMP_KEY},
timeout=15,
)
resp.raise_for_status()
df = pd.DataFrame(resp.json())
# 提取 按名称查 SEC 申报 核心列:symbol, name, cik, sicCode
df = df[["symbol", "name", "cik", "sicCode"]].dropna(how="all")参数使用和避坑
2 组参数组合 · 2 条避坑以下列出本接口在高频投研与回测场景下的常用 Query 参数组合写法:
| 投研场景 | Query 参数组合示例 | 返回数据特征与用途 |
|---|---|---|
| 按 company=Berkshire 拉取按名称查 SEC 申报 | company=Berkshire | 向 /stable/sec-filings-company-search/name 传 company=Berkshire,提取匹配的 name、sicCode、industryTitle(如 name=BERKSHIRE MULTIFAMILY VA…)。 |
| 切换 company=MSFT 查询按名称查 SEC 申报 | company=MSFT | 改传 company=MSFT 访问 /stable/sec-filings-company-search/name,对比不同过滤条件下的 name、sicCode、industryTitle。 |
解析 /stable/sec-filings-company-search/name 产出的按名称查 SEC 申报(必填 company)时,注意 name(如 BERKSHIRE MULTIFAMILY VA…)在部分标的上可能为 null 或空串,下游关联前需做空值过滤。
本地维护按名称查 SEC 申报底表(源自 /stable/sec-filings-company-search/name)时,主键定为 (symbol, cik, industryTitle);读取 name(名称,样本 BERKSHIRE MULTIFAMILY VA…)做多表 Join 前先剔除空值。
返回数据
7 个字段本接口示例响应共包含 7 个字段(数值型 0 个,文本/日期/布尔型 7 个)。下表列出全部字段名、类型、首条记录真实样本值与中文释义,实际返回会因接口与数据状态有所不同。
| 字段 | 类型 | 示例值 | 说明 |
|---|---|---|---|
symbol | string | "None" | 证券代码 |
name | string | "BERKSHIRE MULTIFAMILY VALUE FU…" | 名称 |
cik | string | "0001418405" | SEC CIK 编号(SEC 10 位定长中央索引键,落库须定义为 VARCHAR(10) 字符串以防前导零丢失) |
sicCode | string | "" | SIC 行业代码 |
industryTitle | string | "" | 行业分类名称 |
businessAddress | string | "c/o Berkshire Property Advisor…" | 营业地址 |
phoneNumber | string | "(617) 646-2300" | 电话号码 |
查看响应数据示例(原始 JSON)
[
{
"symbol": "None",
"name": "BERKSHIRE MULTIFAMILY VALUE FUND II LP",
"cik": "0001418405",
"sicCode": "",
"industryTitle": "",
"businessAddress": "c/o Berkshire Property Advisors LLC, Boston MA 02108",
"phoneNumber": "(617) 646-2300"
}
]常见问题解答(FAQ)
2 个问题在实际量化建模中,按名称查 SEC 申报与 按表格类型查 SEC 申报(/stable/sec-filings-search/form-type)是如何互补联动的?
向 /stable/sec-filings-company-search/name 请求按名称查 SEC 申报需遵循必填 company,返回 name(名称,样本 BERKSHIRE MULTIFAMILY VA…)等 7 项;而 SEC Filings By Form Type(按表格类型查 SEC 申报)遵循必填 formType, from, to并返回 7 项。
回测需要多期或多标的按名称查 SEC 申报,调用 /stable/sec-filings-company-search/name 应该如何组织请求?
您可以按 company 过滤条件请求 /stable/sec-filings-company-search/name 并做非空校验;在落盘 按名称查 SEC 申报 的 name 与 sicCode 时,建议将原始响应分批转换为列式存储。
同模块相关接口对比
Search Filings本接口路径 /stable/sec-filings-company-search/name,必填参数 company。 同一模块「Search Filings」下共 4 个接口,下表列出其余 3 个, 按粒度与查询维度对比,避免选错接口。
| 接口 | 路径 | 核心差异与适用场景 |
|---|---|---|
| 按表格类型查 SEC 申报SEC Filings By Form Type | /stable/sec-filings-search/form-type | 按监管表单类型与日期区间批量检索全市场 SEC EDGAR 申报文件及原文链接 |
| 按代码查 SEC 申报SEC Filings By Symbol | /stable/sec-filings-search/symbol | 按股票代码与起止日期区间查询指定上市公司的全部美国证监会(SEC)监管申报记录 |
| 按 CIK 查 SEC 申报SEC Filings By CIK | /stable/sec-filings-search/cik | 按 SEC 10 位 CIK 编号查询指定主体提交的历史监管申报文件清单 |