# IP 查询 API（api.ip.denys.cn）

> 面向开发者与 AI 应用的 IP 归属地查询 API：支持 IPv4/IPv6 与批量查询，毫秒级返回国家、省份、城市、运营商，并附带 20+ 个字段——是否中国大陆（is_china_mainland）、地区归类（mainland/hk/mo/tw/overseas）、大洲码、国际电话区号（港澳台独立）、省级行政区划代码/拼音/简码/简称、国内大区、城市拼音/简码/电话区号、时区（IANA 名），以及 ASN 自治系统号与所属组织；按次计费、仅查询命中计费，次数长期有效，注册即送 1,000 次免费额度。

## 站点

- [首页](https://api.ip.denys.cn/)：产品介绍，可在线查看你当前 IP 的归属地
- [定价](https://api.ip.denys.cn/pricing)：套餐价格表（¥5 起）
- [接口文档](https://api.ip.denys.cn/docs)：鉴权、返回格式、计费规则、错误码、多语言示例

## API 摘要

- 单查：`GET https://api.ip.denys.cn/v1/query?ip=223.5.5.5`（省略 ip 参数时查询调用方 IP）
- 批量：`POST https://api.ip.denys.cn/v1/query`，请求体 `{"ips":["223.5.5.5","119.29.29.29"]}`，单次最多 100 个
- 鉴权：请求头 `X-API-Key: ipk_xxx`（控制台创建）
- 响应字段：ip, found, country, province, city, isp, country_code, is_china_mainland, region, continent_code, phone_prefix, china_province_code, china_city_code, province_pinyin, province_short_code, province_abbr, china_region, city_code, city_short_code, city_area_code, timezone, asn, as_org
- 计费：仅 found=true 计 1 次；成功响应头 X-Quota-Remaining 为剩余次数
- 限流：每个 API Key 约 50 次/秒，超出返回 429
- AI Agent 接入：MCP 远程端点 `POST https://api.ip.denys.cn/mcp`（JSON-RPC 2.0，工具 ip_query / ip_batch / ip_quota，鉴权同上）

## 完整文档

- [llms-full.txt](https://api.ip.denys.cn/llms-full.txt)：全部接口参考与代码示例的单文件版（推荐给 AI 直接读取）