集成前,请先查看实时服务运行状况和文档中说明的失败响应。
被这些公司的人员使用
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
每月 1,000 个免费积分,即刻开始。需要更多?可选择月度方案,或购买一次性积分包。
这个 API 可以帮你交付什么
把此页面当作生产集成简报:端点、示例、响应结构,以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本,而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
使用文档中的请求头发送 API 密钥,并在服务之间保持请求一致。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前,快速查看输入、输出字段和状态码。
参数
响应示例
HTTP 状态码
API 端点
/v1/company/resolve
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
集成前,请先查看实时服务运行状况和文档中说明的失败响应。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 文档链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
每月 1,000 个免费积分,即刻开始。需要更多?可选择月度方案,或购买一次性积分包。
主要功能
可查询任意交易所或你指定交易所的股票代码,查询时会校验 ISIN 的校验位,也可查询公司名称,并自动忽略 Inc.、AG、S.A. 等公司类型后缀。
当一个股票代码或名称对应多家公司时,会返回所有候选项及其交易所和域名,而不是替你选一个。
每个候选项都会列出其标识符、把它与网站关联起来的声明、一致的来源以及置信度。
使用 match=prefix,可在用户输入时推荐公司,并按名称匹配程度排序。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/company/resolve?ticker=AAPL"
响应示例
{
"query": { "type": "ticker", "value": "AAPL", "exchange": null, "match": null, "limit": null },
"status": "present",
"reason": "resolved",
"domain": "apple.com",
"website": "https://apple.com/",
"company": {
"id": "wikidata:Q312",
"name": "Apple Inc.",
"domain": "apple.com",
"domains": ["apple.com", "apple.com.cn"],
"identifiers": {
"wikidata": "Q312",
"cik": "0000320193",
"isins": ["US0378331005"],
"listings": [
{ "ticker": "AAPL", "exchange": { "name": "Nasdaq", "mic": "XNAS", "wikidata": "Q82059" }, "source": "sec" }
]
},
"confidence": "high",
"match": { "field": "ticker", "value": "AAPL", "kind": "exact" },
"sources": ["sec", "wikidata"]
},
"checked_at": "2026-11-02T10:00:00.000Z"
}
常见问题解答
来自开放的公共数据:美国上市公司使用美国证券交易委员会(SEC)的公司股票代码列表,每天刷新;交易所上市信息、ISIN 和官方网站来自 Wikidata,每周刷新。每个候选项都会显示它来自哪一个。
结果为“未知”,原因是 ticker_on_multiple_exchanges,并列出使用该代码的所有公司。传入 exchange(例如 XNAS 或 Tokyo Stock Exchange)即可选定其中一个。
不是。数据来源并未覆盖所有公司和上市信息,因此查不到的标识符会报告为“未知”,绝不会当作它不存在的证据。
每次请求消耗 1 个额度,未知和有歧义的结果也一样,因为仍会返回候选项。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
API 密钥或会话缺失或无效。
没有足够额度来执行此请求。
超出速率限制

