面向开发者设计的IP查询API接口，提供HTTP GET/POST调用方式，返回标准JSON格式结构化数据。包含国家、省份、城市、运营商、ASN自治系统号、IP类型、风险标签、时区、经纬度等十余项字段，支持IPv4/IPv6双栈查询。
为开发者量身打造的 IP 查询接口
所有接口均返回标准 JSON 格式，字段命名清晰、嵌套层级合理，可被任何主流编程语言直接解析，无需额外处理。
同时支持 IPv4 与 IPv6 地址查询，自动识别地址类型并返回对应的归属地数据，对双栈网络环境无缝适配。
除基础归属地外，额外输出 IP 类型（住宅/数据中心/VPN/移动）、纯净度评级、风险标签（如 cloud、tor、proxy）等结构化标签。
四级接口自动备切架构，平均响应时间低于 100 毫秒，99.9% 查询成功率，适合高并发生产环境集成。
单次请求支持最多 100 条 IP 批量查询，请求体采用 JSON 数组格式，响应返回与请求顺序一一对应的结果数组。
提供 Python、Node.js、Java、Go、PHP、curl 等多种语言的官方 SDK 与示例代码，5 分钟完成集成。
4 个核心端点覆盖所有 IP 查询场景
查询单个 IP 地址的完整归属地信息，{ip} 替换为目标 IPv4 或 IPv6 地址。支持域名自动解析（DNS → IP → 归属地）。
查询调用方自身的公网 IP 归属地信息。无需传入 IP 参数，服务端自动识别请求来源 IP 并返回结果。
批量查询接口，请求体为 JSON 数组（最多 100 条 IP），响应返回与请求顺序一一对应的结果数组，适合日志分析场景。
深度风险评估接口，返回更详细的 IP 类型、代理标记、滥用记录、黑名单状态等风险数据，适合风控场景。
5 分钟完成集成，覆盖主流编程语言
pip install iptools-api
npm install iptools-api
Maven / Gradle
go get iptools-api
标准 JSON 格式，所有字段命名清晰、类型一致
每个字段都有清晰的含义与用途
查询的目标 IP 地址，原样返回。
IP 协议版本，4 或 6。
国家/地区名称（英文），country_code 为两位 ISO 代码。
省级行政区划名称。
城市名称，地级市或省会级别。
纬度坐标，longitude 为经度，WGS-84 坐标系。
IANA 时区标识，如 Asia/Shanghai。
运营商或机构名称。
自治系统编号，org 为 ASN 持有人。
IP 类型：residential / datacenter / mobile / vpn。
风险标签数组，如 cloud、tor、proxy、abuse。
纯净度评级：high / medium / low。
面向开发者的 IP 查询集成方案
用户注册、登录、下单时通过 API 查询 IP 归属地与风险标签，识别异地登录、代理下单、机房批量注册等异常行为。
在日志收集管道中集成 API，自动为访问 IP 打上国家、城市、ASN 标签，便于后续地域分布统计与异常访问告警。
Web 服务端根据用户 IP 归属地自动切换语言、货币、配送地区，提升跨境业务的本地化体验与转化率。
用户提交 IP 后调用 API 判断是否为数据中心 IP、Tor 出口或已知代理节点，自动拦截批量注册行为。
广告投放平台集成 API 后，自动识别点击 IP 是否为机房 IP 或重复点击，输出反作弊评分。
金融、政务等强合规场景记录用户访问 IP 的归属地、ASN、风险标签，满足监管对访问来源审计的要求。
接口可用性
平均响应时间
并发能力
标准响应格式
关于 IP 查询 API 接口的 8 个核心疑问
/v1/ip/8.8.8.8），POST 请求将参数放入 JSON 请求体。认证采用Bearer Token 方式，在 HTTP Header 中加入 Authorization: Bearer YOUR_API_KEY 即可。免费版每日提供 1000 次调用额度，无需信用卡，开箱即用。response = requests.get('https://api.iptools-address.com.cn/v1/ip/8.8.8.8', headers={'Authorization': 'Bearer YOUR_KEY'})。Node.js 示例：const res = await fetch('https://api.iptools-address.com.cn/v1/ip/8.8.8.8', {headers: {'Authorization': 'Bearer YOUR_KEY'}})。官方提供 Python、Node.js、Java、Go、PHP、Ruby 等 6 种语言的 SDK，可通过 pip install iptools-api、npm install iptools-api 直接安装，详细文档与示例见下载页面。error_code 与 error_message 字段说明具体原因。/v1/ip/batch，请求体为 JSON 数组（最多 100 条 IP），响应返回与请求顺序一一对应的结果数组。例如：["8.8.8.8", "1.1.1.1", "208.67.222.222"] 返回对应 3 条结果。批量接口采用并发调度，每批 10 条同时请求，100 条 IP 平均 5 秒内完成。建议生产环境使用批量接口替代单条循环调用，可显著提升吞吐量。