集成前,请先查看实时服务运行状况和文档中说明的失败响应。
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
这个 API 可以帮你交付什么
把此页面当作生产集成简报:端点、示例、响应结构,以及把 DomScan 接入产品所需的工作流组件。
把域名检查、DNS 情报、风险信号或数据增强嵌入注册、搜索和内部工具。
用计划任务、告警和可复现的调查步骤替代重复的人工查询。
使用可预测字段、已记录的状态码和积分成本,而不是抓取供应商页面。
通过 OpenAPI、SDK、Postman 或 MCP 为代理、仪表板、SOAR 剧本和 CRM 提供数据。
集成流程
从第一次请求到可重复生产使用的简单路径。
使用文档中的请求头发送 API 密钥,并在服务之间保持请求一致。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
使用状态码、积分成本和响应字段构建重试、日志和告警。
开发者工具包
从此页面跳转到机器可读文档、请求集合、SDK 或代理工具。
参数和响应映射
在把端点接入客户端前,快速查看输入、输出字段和状态码。
参数
响应示例
HTTP 状态码
API 端点
/v1/reverse/ip
集成前可见的信任信号
透明文档、已认证请求和清晰的可靠性信息,让你在上线前更容易评估 DomScan。
OpenAPI、Swagger、Postman、CLI、SDK 和 MCP 链接一键可达。
认证端点使用 API 密钥,并在调用前清楚显示积分成本。
从每月 10,000 积分开始,只有在用量增长时再升级。
从 curl 和 HTTP 示例开始,再把参数映射到你的应用代码。
主要功能
只从由 /v1/dns/all 查询填充的每 IP 尽力而为索引中返回最近 limit 条记录,默认启用根域名去重。
此端点不会抓取 DNS、区域文件或完整的被动 DNS 语料库。
结果只能作为可选上下文,不能视为调查或销售数据的完整证据。
只从由 /v1/dns/all 查询填充的每 IP 尽力而为索引中返回最近 limit 条记录,默认启用根域名去重。
此端点不会抓取 DNS、区域文件或完整的被动 DNS 语料库。
结果只能作为可选上下文,不能视为调查或销售数据的完整证据。
此端点不会抓取 DNS、区域文件或完整的被动 DNS 语料库。
结果只能作为可选上下文,不能视为调查或销售数据的完整证据。
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/reverse/ip?ip=93.184.216.34"
响应示例
{
"query": {
"ip": "93.184.216.34",
"asn": null,
"expand": "none",
"dedupe_apex": true
},
"deprecated": true,
"deprecation_notice": "This endpoint is deprecated. It only searches a best-effort seven-day passive index populated by prior /v1/dns/all lookups and capped at 10,000 recent entries per key. It is not an internet-wide reverse DNS dataset.",
"ip_context": null,
"results": [],
"summary": {
"total_found": 0,
"returned": 0
},
"coverage_summary": {
"source": "passive_dns",
"cache_status": "passive_cache_only",
"passive_index": true,
"result_count": 0,
"returned_count": 0,
"apex_deduped_count": 0,
"warning_count": 2,
"warnings": ["passive_cache_only", "no_cached_matches"],
"last_seen_span_days": null
},
"page": {
"limit": 100,
"next_cursor": null
},
"meta": {
"source": "passive_dns",
"note": "Best-effort seven-day index populated only by prior /v1/dns/all lookups"
},
"cache": {
"hit": null,
"age_s": null,
"ttl_s": null,
"key": null
}
}
常见问题解答
已弃用:此端点只在由先前 /v1/dns/all 查询填充的七天尽力而为索引中查询有效的 IPv4 或 IPv6 地址。每个 IP 最多保留最近 10,000 条记录。API 先评估 limit 条记录,再默认每个根域名返回一行。它不是全网数据集。
结果只能作为可选上下文,不能视为调查或销售数据的完整证据。
该尽力而为索引仅由 /v1/dns/all 查询填充,观测记录保留七天,每个 IP 最多保留最近 10,000 条。记录缺失或写入失败会造成空缺。
接受有效的 IPv4 和 IPv6 字面值,并在查询尽力而为索引前进行标准化。结果仍取决于先前的 /v1/dns/all 观测记录。
相关工具和资源
HTTP 状态码
我们明确列出了客户端应处理的 HTTP 状态码,帮助你区分成功响应、认证问题、额度不足、速率限制、数据不存在以及上游故障。
请求成功
参数无效
API 密钥或会话缺失或无效。
没有足够额度来执行此请求。
超出速率限制
内部错误
上游 RDAP 错误
上游服务不可用或正在临时限流。
上游查询已超时。