可用接口
常用接口包括当前 IP、任意 IP 查询、批量查询、多源覆盖和 DNS 出口检测。所有接口都支持 IPv4 与 IPv6;私网地址会返回不适用提示。
- GET /api/me?lang=en — 当前访客出口 IP 与报告
- GET /api/lookup?ip=8.8.8.8&lang=en — 查询任意地址
- GET /api/sources?ip=8.8.8.8&lang=en — 16 源参考覆盖
- POST /api/batch — 批量查询(有更严格限流)
- GET /api/dnsleak?lang=en — DNS 出口探测
curl 示例
从终端直接调用即可;把 8.8.8.8 换成你要查询的地址。
curl https://ip-find.com/api/me?lang=en
curl "https://ip-find.com/api/lookup?ip=8.8.8.8&lang=en"
curl "https://ip-find.com/api/sources?ip=8.8.8.8&lang=en"
响应里有什么?
主报告包含 IP、归属地、ASN、ISP、网络类型、原生 IP、风险评分和公开标签;多源接口返回 16 个来源的状态和维度。字段命名以 /openapi.json 为准,避免把展示文案当成稳定协议。
限流、隐私与使用边界
接口按 IP 做防滥用限流,正常调试不会感觉到;批量接口限制更严格。没有账号系统,也没有付费套餐。查询结果不用于广告画像,缓存只在内存中短期存在。
接口适合查询公开网络信息,不适合用来定位个人、绕过平台风控或批量抓取第三方数据。请遵守目标平台条款和当地法律。
常见问题
API 免费吗?
当前所有公开接口都免费,没有付费套餐;按 IP 做防滥用限流。
需要 API key 吗?
不需要。直接调用即可;如果以后增加鉴权,会先在文档中说明。
支持 IPv6 和批量吗?
支持 IPv6;批量查询使用 POST /api/batch,限制比单次查询更严格。
有 SLA 或商业授权吗?
这是独立自建服务,不承诺企业级 SLA。商业使用前请先阅读文档并自行评估可用性。
打开完整 API 文档
交互式文档包含全部参数、响应示例和错误码;OpenAPI 规范可以直接导入客户端或代码生成器。