IP 地区查询
根据 IP 地址查询国家、地区、城市等地理归属信息。
GET /api/free/ip-geo在线IP 地区查询
上传、设置、预览与下载都不需要 API Key。
无需登录或 API Key
1. 上传与设置
无需 API Key 即可在线处理；只有点击运行后，文件才会发送到本站。
IP 地址 *
填写必填参数后即可运行工具。GET /api/free-online/ip-geo
2. 预览与下载
结果将在这里显示
包含预览、文件大小变化和下载按钮
通过 API 接入
仅程序调用需要 API Key；参数、响应和错误信息集中展示。
API 接口
GET /api/free/ip-geo在线使用免 Key；程序调用此接口时需要 APIAny Key。
工作原理
- 通过查询参数 ip 传入 IP。未传入时，如果代理请求头可用，将自动使用调用方 IP。
- 返回国家代码、国家名称、地区、城市、经纬度和时区等信息。
响应结果
请求成功后返回 json 类型响应，Content-Type 与本页说明一致。
常见错误
- 400
- 缺少文件或参数、值无效，或者超出页面标注的限制。
- 401
- 程序调用缺少 API Key，或 Key 无效、已停用。
- 429
- 在线或鉴权调用已达到共享限速。
参数与限制
| 参数 | 要求 | 默认值 | 可用值 |
|---|---|---|---|
ipIP 地址 | 必填 | — | text |
API 调用示例
下面是用于程序代码的鉴权示例；上方在线 Playground 不会要求或暴露你的 API Key。
curl "https://apiany.ai/api/free/ip-geo?ip=8.8.8.8" \ -H "Authorization: Bearer $API_KEY"
常见问题
使用 IP 地区查询 需要 API Key 吗？
在线 Playground 无需 Key；程序请求请通过 Authorization: Bearer 或 X-API-Key 发送 APIAny Key。
IP 地区查询 有哪些使用限制？
在线工具每分钟最多 3 次、每天 30 次；鉴权免费账户为 5 RPM，付费账户为 500 RPM，并在全部免费 API 间共享。
IP 地区查询 支持哪些输入？
请按参数表提供必填与选填字段；不支持的格式和超出范围的值会被拒绝。
IP 地区查询 返回什么？
成功请求返回 json 响应；失败时使用上方列出的 HTTP 状态码。
信息来源：APIAny 免费 API 目录与实际路由行为。内容复核日期：2026-07-17。