IPv4 查询 API

国家、地区、城市、大致坐标、时区、网络及其背后的运营商、数据中心和代理标记，以及一个威胁信息块，说明该地址是否曾因滥用或攻击被举报，以及严重程度。省略 ip 参数即可获得调用方自己的地址，这是网站最常见的用法。

GEThttps://api.mygeocode.com/v1/ipv4?ip=...

示例

请求

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4?ip=8.8.8.8"

# The caller's own address
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4"

IP 地址的城市级地理定位是一种估算，并且永远如此；IP 地址属于一个网络，而不是一个人。国家信息对远超 99% 的地址都是准确的。城市信息对家庭宽带运营商最可靠，对移动运营商和数据中心最不可靠，这正是我们对后两者进行标记的原因。

响应

{
  "status": "ok",
  "ip": "1.0.164.165",
  "version": 4,
  "found": true,
  "prefix": "1.0.164.0/24",
  "country": "Thailand",
  "country_code": "TH",
  "continent": "Asia",
  "continent_code": "AS",
  "region": "Krung Thep Maha Nakhon",
  "region_code": null,
  "city": "Bangkok",
  "postcode": "10200",
  "lat": 13.749976,
  "lon": 100.516819,
  "timezone": "Asia/Bangkok",
  "utc_offset": "+07:00",
  "utc_offset_seconds": 25200,
  "is_eu": false,
  "asn": 23969,
  "as_name": "TOT Public Company Limited",
  "org": "TOT Public Company Limited",
  "usage_type": "Eyeball",
  "registry": "apnic",
  "allocated": "2008-10-22",
  "tags": ["dsl"],
  "is_anycast": false,
  "is_satellite": false,
  "is_datacenter": false,
  "is_proxy": false,
  "is_vpn_provider": false,
  "is_tor": false,
  "is_private": false,
  "abuse_email": "abuse@totisp.net",
  "threat": {
    "listed": true,
    "score": 90,
    "source_count": 2,
    "categories": ["abuse", "attacker"],
    "is_tor": false,
    "is_tor_exit": false,
    "is_bogon": false,
    "listings": [
      { "category": "abuse", "confidence": 100, "recency_days": 1 },
      { "category": "attacker", "confidence": null, "recency_days": null }
    ]
  },
  "updated_at": "2026-09-18 06:53:39"
}

返回内容

字段	含义
`country`, `country_code`	国家名称和 ISO 3166-1 alpha-2 代码。
`region`, `region_code`	州、省或同级行政区，以及其 ISO 3166-2 代码（如有）。
`city`, `postcode`	对城市和邮政编码的最佳估计。未知时不返回。
`lat`, `lon`	城市的坐标；若无，则为地区或国家的中心点。
`timezone`	IANA 名称，根据位置确定。
`asn`, `org`	自治系统号，以及宣告该前缀的组织。
`is_datacenter`	该地址位于托管或云服务网段。请将城市视为不可靠，并考虑该流量可能是自动化的。
`is_proxy`, `is_tor`, `is_vpn_provider`	针对单个地址的 Tor 中继或代理列表证据；另外单独说明该运营商是否提供 VPN 服务。
`usage_type`, `tags`, `registry`, `allocated`, `abuse_email`	运营该网络的运营商类型、其运营商标签、由哪个注册机构在何时分配，以及其滥用举报联系方式。
`threat`	信誉信息块：是否被列入名单、0 到 100 的评分、有多少份独立报告列出了该地址及其所属类别、Tor 和 bogon 标记，以及每条列表记录的置信度和时长。每日更新。

使用场景

首次访问的本地化

在访客输入任何内容之前，预先选好默认的国家、货币、语言和单位。从您的服务器将访客的地址作为 ip 传入。

欺诈与滥用信号

将 IP 所在国家与账单国家进行比较。把 is_proxy 和 is_datacenter 当作信号，而不是定论。

无 Cookie 的访问分析

在服务器端根据访问日志按国家和地区汇总访问量，完全不需要客户端跟踪。

价格和限制

一次调用计为一个请求；批量查询中每个地址计为一个请求。每个密钥每天有 2,500 次免费请求；超出后，每次请求从预付额度中扣除 €0.0001，使用 Unlimited 密钥（每月 €50）则不收费。价格。正在从 ip-api、ipinfo 或 ipstack 迁移？这些格式都有对应的兼容替换主机。IPv6 地址请参阅 IPv6 查询 API。