公司搜索 API

按公司名称、股票代码或十位 CIK 查找覆盖范围内的 SEC 发行人。

端点与请求

使用 Narwhal API 密钥即可获得。

REST 端点

GET /v1/companies

请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP 使用 companies_search 使用下面对应的参数。REST 和 MCP 返回相同的响应架构，并共享额度计数。

参数

名称	必填	类型	含义
`query`	是	查询·字符串，1–200 个字符	公司名称、股票代码或十位 CIK。名称和股票代码匹配不区分大小写。
`limit`	否	查询·整数，1–100	返回公司的最大数量。默认为 20。
`cursor`	否	查询·不透明字符串	来自上一页的续接令牌。它绑定到原始查询和筛选条件。

响应

{
  "query": "AAPL",
  "companies": [
    {
      "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
      "name": "Apple Inc.",
      "cik": "0000320193",
      "listings": [
        {
          "ticker": "AAPL",
          "exchange": "Nasdaq"
        }
      ]
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

字段	类型	必填	含义
`query`	字符串	是	标准化后的搜索文本。
`companies`	数组	是	具有 CIK 和当前上市别名的稳定公司身份。
`next_cursor`	字符串或 null	是	不透明的续页令牌；页面完成时为 null。
`as_of`	UTC时间戳	是	页面中每个结果共享的快照时间。

错误与配额

400 invalid_query — 查询、日期、表格、限制或游标无效。
401 invalid_api_key — Bearer 密钥缺失或被拒绝。
429 rate_limit_exceeded 或 quota_exhausted — 共享短窗口或月度额度已耗尽。
503 companies_unavailable — Companies 已禁用、权限未启用，或无法提供完整的已接受发布版本。

认证失败和被拒绝的限流请求不会消耗月度额度。成功的 REST 和 MCP 调用使用同一账户限额。

首版发布范围

上线群组源自已接受的 SEC 股票代码与 CIK 关联快照。返回的股票代码是别名，不能证明存在活跃上市。

覆盖范围仅限于已接受的发行方群体。请读取响应中的 as_of 时间和覆盖范围页面，以了解可用快照。