IP Address Geolocation, by 🐚 The 17711 Mesh

Fast IP geolocation API : country, city, coordinates, ASN, timezone. MaxMind GeoLite2 powered, updated daily. Bulk lookup up to 144 IPs per request.

原始信息汇总

IP Address Geolocation, by 🐚 The 17711 Mesh 数据集概述

基本信息

• 数据集名称: IP Address Geolocation, by 🐚 The 17711 Mesh
• 类别: Location
• 提供者: 17711
• 当前版本: 0.5.0
• 基础URL: https://services.17711.org
• 数据源: MaxMind GeoLite2 (City + ASN databases)
• 数据更新频率: 每日更新

功能描述

这是一个快速的IP地理定位API，可提供国家、城市、坐标、自治系统号（ASN）和时区信息。支持批量查询，每次请求最多可查询144个IP地址。

性能指标

• 流行度: 9.1
• 服务等级: 100%
• 延迟: 76ms
• 测试覆盖率: 100%
• 缓存: LRU缓存（1597个条目），用于加速重复查询

数据精度

• 国家级别精度: 约99%
• 城市级别精度: 约70%
• 私有/保留IP地址（如10.x, 192.168.x, 127.x）返回空结果。

端点（Endpoints）

1. GET /api/geolocalisation/ip-address/v0.1.0/lookup

查询单个IP地址的地理位置信息。

• 查询参数:

  • ip (必需): 要查询的IPv4或IPv6地址。

• 示例请求:

  GET /api/geolocalisation/ip-address/v0.1.0/lookup?ip=8.8.8.8

• 响应示例 (JSON): json { "ip": "8.8.8.8", "country": "US", "country_name": "United States", "city": null, "latitude": 37.751, "longitude": -97.822, "asn": 15169, "org": "Google LLC", "timezone": "America/Chicago" }

2. POST /api/geolocalisation/ip-address/v0.1.0/bulk

在单个请求中批量查询多个IP地址的地理位置信息。每次请求最多144个IP。

• 请求体 (JSON): json { "ips": ["8.8.8.8", "1.1.1.1", "51.68.124.241"] }

• 响应示例 (JSON): json { "results": [ { "ip": "8.8.8.8", "country": "US", "country_name": "United States", "city": null, "latitude": 37.751, "longitude": -97.822, "asn": 15169, "org": "Google LLC", "timezone": "America/Chicago" }, { "ip": "1.1.1.1", "country": "AU", "country_name": "Australia", "city": null, "latitude": -33.494, "longitude": 143.2104, "asn": 13335, "org": "Cloudflare, Inc.", "timezone": "Australia/Sydney" }, { "ip": "51.68.124.241", "country": "FR", "country_name": "France", "city": "Strasbourg", "latitude": 48.5734, "longitude": 7.7521, "asn": 16276, "org": "OVH SAS", "timezone": "Europe/Paris" } ], "total": 3, "resolved": 3 }

3. GET /api/geolocalisation/ip-address/v0.1.0/cache-stats

返回内部缓存统计信息。

• 响应示例: json {"cache_entries": 542}

4. GET /api/geolocalisation/ip-address/v0.1.0/health

健康检查端点（无需认证）。

• 响应示例:

  ok

认证

所有端点（除健康检查外）都需要在请求头中提供由RapidAPI提供的X-RapidAPI-Proxy-Secret，或使用网格认证头。

订阅计划与速率限制

计划	价格（每月）	每月配额	速率限制
Free	$0.00	1,000	1次/秒
Starter (PRO)	$3.00	10,000	3次/秒
Basic (ULTRA)	$8.00	50,000	5次/秒
Pro (MEGA)	$21.00	500,000	13次/秒

错误代码

代码	含义
200	成功
400	缺少ip参数
401	缺少或无效的认证信息
429	超出速率限制

法律声明

• 本产品包含由MaxMind创建的GeoLite2数据，可从maxmind.com获取。