IP 地理位置 API 参考

Q: 在哪里可以找到 IP 地理位置 的请求和响应参考？

使用 IP 地理位置 的 API 参考来查看参数、响应字段、示例、状态码和支持的操作模式。

你将获得什么

获取 IP 地址的地理位置数据，包括国家/地区、城市和 ISP。

同步RESTMCPSDK交互式工具

适合选择此产品的场景

适用对象

将此套件用于故障排查、迁移检查、基础设施研究和安全审查。

适合选择此产品的场景

存在公开证据时，需要为 IP 地址添加网络、位置和所有权上下文时选择。

你将获得什么

获取 IP 地址的地理位置数据，包括国家/地区、城市和 ISP。

端点

集成前，请查看支持的操作、输入、输出、执行模式和响应限制。

GET /v1/ip 查看 API 参考

积分和身份验证

1 需要身份验证。有关确切费用和按项计费，请查看操作参考。

操作示例

使用文档化的操作来收集、评估、补充、验证、比较、保护或监测公开证据。

GET /v1/ip

查询参数

参数	类型	必需
ip	string	可选
domain	string	可选

响应字段

字段	类型
`ip`	string
`domain`	string \| null
`geolocation`	object
`geolocation.country`	string \| null
`geolocation.country_name`	string \| null
`geolocation.region`	string \| null
`geolocation.region_name`	string \| null
`geolocation.city`	string \| null
`geolocation.postal`	string \| null
`geolocation.latitude`	number \| null
`geolocation.longitude`	number \| null
`geolocation.timezone`	string \| null
`geolocation.precision`	string
`network`	object
`network.asn`	integer \| null
`network.asn_name`	string \| null
`network.asn_org`	string \| null
`network.isp`	string \| null
`network.connection_type`	string \| null
`security`	object
`security.is_proxy`	boolean
`security.is_vpn`	boolean
`security.is_tor`	boolean
`security.is_tor_exit`	boolean
`security.is_datacenter`	boolean
`security.is_cloud`	boolean
`security.cloud_provider`	string \| null
`security.threat_score`	integer
`security.is_vpn_suspected`	boolean
`security.vpn_suspected_provider`	string \| null
`security.type_classification`	object
`security.type_classification.type`	string
`security.type_classification.confidence`	string
`security.fcrdns`	object
`security.fcrdns.ptr`	string \| null
`security.fcrdns.fcrdns_valid`	boolean \| null
`intelligence_summary`	object
`intelligence_summary.query_type`	string
`intelligence_summary.domain_resolved`	boolean
`intelligence_summary.cache_status`	string
`intelligence_summary.data_source`	string
`intelligence_summary.confidence`	string
`intelligence_summary.confidence_score`	integer
`intelligence_summary.asn_present`	boolean
`intelligence_summary.organization_present`	boolean
`intelligence_summary.country_present`	boolean
`intelligence_summary.security_signal_count`	integer
`intelligence_summary.risk_flags[]`	string[]
`intelligence_summary.hosting_category`	string
`meta`	object
`meta.query_time_ms`	integer
`meta.cached`	boolean
`meta.source`	string
`meta.data_updated_at`	string \| null
`meta.attribution`	object
`meta.attribution.name`	string
`meta.attribution.url`	string
`meta.attribution.license`	string
`meta.attribution.license_url`	string
`meta.attribution.modified`	boolean
`meta.warning_code`	string \| null

请求示例

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8&domain=status.openai.com"

响应示例

{
  "ip": "8.8.8.8",
  "domain": null,
  "geolocation": {
    "country": "US",
    "country_name": "United States",
    "region": null,
    "region_name": "California",
    "city": "Mountain View",
    "postal": null,
    "latitude": 37.422,
    "longitude": -122.085,
    "timezone": null,
    "precision": "city"
  },
  "network": {
    "asn": 15169,
    "asn_name": "AS15169",
    "asn_org": "Google LLC",
    "isp": null,
    "connection_type": "hosting"
  },
  "security": {
    "is_proxy": false,
    "is_vpn": false,
    "is_tor": false,
    "is_tor_exit": false,
    "is_datacenter": true,
    "is_cloud": true,
    "cloud_provider": "Google Cloud",
    "threat_score": 0,
    "type_classification": {
      "type": "datacenter",
      "confidence": "high"
    },
    "fcrdns": {
      "ptr": "dns.google",
      "fcrdns_valid": true
    }
  },
  "intelligence_summary": {
    "query_type": "ip",
    "domain_resolved": false,
    "cache_status": "miss",
    "data_source": "db-ip-lite+enrichment",
    "confidence": "high",
    "confidence_score": 100,
    "asn_present": true,
    "organization_present": true,
    "country_present": true,
    "security_signal_count": 2,
    "risk_flags": [
      "cloud",
      "datacenter"
    ],
    "hosting_category": "cloud"
  },
  "meta": {
    "query_time_ms": 118,
    "cached": false,
    "source": "db-ip-lite+enrichment",
    "data_updated_at": "2026-08-01T01:42:04.000Z",
    "attribution": {
      "name": "DB-IP Lite",
      "url": "https://db-ip.com",
      "license": "CC BY 4.0",
      "license_url": "https://creativecommons.org/licenses/by/4.0/",
      "modified": true
    }
  }
}