IP Geo Location
收藏RapidAPI2026-06-30 更新2026-07-02 收录
下载链接：
https://rapidapi.com/bref-tech-bref-tech-default/api/ip-geo-location16
下载链接
链接失效反馈官方服务：
资源简介：
Fast, reliable IP geolocation with a generous free tier. Country, city, region, coordinates and timezone in one clean JSON response.
创建时间：
2026-06-30
原始信息汇总
数据集概述：IP Geo Location
这是一个提供IP地理定位功能的API数据集，可从任意IPv4或IPv6地址获取位置信息。其核心在于通过单一HTTP请求返回国家、地区、城市、坐标和时区等数据。
- 数据集名称：IP Geo Location
- 提供方：Bref Tech
- 所属类别：Location (位置)
- 核心功能：查找任意IPv4或IPv6地址的地理位置。
1. 端点与查询方式
该API提供三个主要端点：
- 单IP查询：
GET /v1/geoip，需提供ip参数（必需），例如：GET /v1/geoip?ip=8.8.8.8。 - 自动查询调用者IP：
GET /v1/geoip/me，无需提供参数，直接返回调用方自身IP的地理位置。 - 批量查询IP：
POST /v1/geoip/bulk，可在一次请求中查询最多100个IP，请求体格式为JSON数组，例如：{"ips": ["8.8.8.8", "1.1.1.1"]}。
2. 返回数据字段
每次成功查询都会返回一个JSON对象，包含以下字段：
| 字段 | 类型 | 描述 |
|---|---|---|
ip |
string | 被查询的IP地址 |
country_code |
string或null | ISO 3166-1 alpha-2国家代码（如 "US"） |
country_name |
string或null | 完整国家名称 |
region |
string或null | 州、省或最具体的行政区划 |
city |
string或null | 城市名称 |
lat |
number或null | 纬度 |
lng |
number或null | 经度 |
timezone |
string或null | IANA时区（如 "America/Los_Angeles"） |
isp |
null | 保留字段，当前版本始终为null |
注意：当数据库缺少某个级别的详细信息时，对应的字段值会返回null。
3. 错误代码
| HTTP状态码 | 含义 |
|---|---|
| 404 | IP未找到（私有、保留或不可路由的地址段） |
| 422 | 无效的IP地址格式 |
| 429 | 超过当前计划的速率限制 |
4. 定价计划
| 计划 | 价格 | 调用限制 |
|---|---|---|
| Basic (免费) | $0.00/月 | 1,000次/天 |
| Pro | $7.99/月 | 10,000次/天 |
| Ultra | $18.99/月 | 35,000次/天 |
| Mega | $39.99/月 | 1,800,000次/月 |
5. 主要特点
- 免费额度：每天提供1,000次免费调用，无需信用卡。
- 高速响应：得益于内存数据库和无第三方调用，响应时间低于50毫秒。
- 批量查询：支持在一个请求中查询最多100个IP。
- 自动检测：提供自动查询调用者IP的端点。
- 数据格式：返回干净、一致的JSON数据。
