IP 归属地查询 API，按次计费
支持 IPv4 与 IPv6，毫秒级返回国家、省市、运营商，附区号、行政区划码、ASN 等 20+ 个字段；单价低至 0.0004 元/次，次数长期有效，注册即送 1,000 次免费试用。
你当前的 IP
海外216.73.216.252
- 国家/地区
- United States
- 省份
- Ohio
- 城市
- Columbus
- 运营商
- Amazon
- 国家代码
- US
- 大洲
- 北美洲
- 国际电话区号
- +1
- 时区
- America/New_York
所属网络（ASN）
AS16509
字段丰富
IPv4/IPv6 均可查询，国家、省份、城市、运营商之外，还返回是否中国大陆、大洲、国际电话区号、 省/市行政区划码、省份拼音/简码/简称、国内大区、城市拼音/简码/电话区号、时区（IANA 名）与 ASN 等，共 20+ 个字段。
按次计费
仅查询命中（found=true）计费，单价低至 0.0004 元/次，次数长期有效，余额透明可查。
批量查询
POST 一次最多查询 100 个 IP，按命中个数计费。
港澳台区分
港澳台与大陆有明确字段区分（is_china_mainland / region），电话区号各自独立（+852/+853/+886）， 判定无需自己维护名单。
AI 原生
提供 MCP 端点与 AI 可读文档，Claude Code、Cursor 等编程助手一行配置接入。
快速上手
curl 'https://api.ip.denys.cn/v1/query?ip=223.5.5.5' -H 'X-API-Key: ipk_your_key'
# 响应
{
"ip": "223.5.5.5",
"found": true,
"country": "中国",
"province": "浙江省",
"city": "杭州市",
"isp": "阿里",
"country_code": "CN",
"is_china_mainland": true,
"region": "mainland",
"continent_code": "AS",
"phone_prefix": "+86",
"china_province_code": "330000",
"province_pinyin": "zhejiang",
"province_short_code": "ZJ",
"province_abbr": "浙",
"china_region": "华东",
"city_code": "hangzhou",
"city_short_code": "HZ",
"city_area_code": "0571",
"china_city_code": "330100",
"timezone": "Asia/Shanghai",
"asn": 45102,
"as_org": "ALIBABA-CN-NET Alibaba US Technology Co., Ltd."
}curl 'https://api.ip.denys.cn/v1/query?ip=2400:3200::1' -H 'X-API-Key: ipk_your_key'
# 响应
{
"ip": "2400:3200::1",
"found": true,
"country": "中国",
"province": "浙江省",
"city": "杭州市",
"isp": "阿里",
"country_code": "CN",
"is_china_mainland": true,
"region": "mainland",
"continent_code": "AS",
"phone_prefix": "+86",
"china_province_code": "330000",
"province_pinyin": "zhejiang",
"province_short_code": "ZJ",
"province_abbr": "浙",
"china_region": "华东",
"city_code": "hangzhou",
"city_short_code": "HZ",
"city_area_code": "0571",
"china_city_code": "330100",
"timezone": "Asia/Shanghai",
"asn": 45102,
"as_org": "ALIBABA-CN-NET Alibaba US Technology Co., Ltd."
}常见问题
多少钱一次？
套餐单价低至 0.0004 元/次（1 元最多可查 2,500 次）：入门 ¥5/5,000 次约 0.001 元/次，旗舰 ¥100/250,000 次为 0.0004 元/次。在同类 IP 查询 API 中属于便宜档，且仅查询命中计费，未命中与出错都不扣次数。
和免费接口、大厂云 API 相比有什么优势？
免费 IP 查询接口通常限流严格、数据更新和稳定性没有保障，随时可能停服或转向收费；大厂云 API 功能全但按量计费单价高。我们只做 IP 归属地查询这一件事，所以能做得更便宜：1 元最多可查 2,500 次，且仅查询命中才计费。
注册后有免费额度吗？
有。注册并完成邮箱验证后自动赠送 1,000 次查询额度，可以先验证数据质量再决定是否付费。
哪些查询会计费？
只在查询成功且有结果（found=true）时计 1 次。IP 格式非法、未收录地址（如内网地址）以及查询失败都不计费；每次成功响应的 X-Quota-Remaining 头会实时返回剩余次数。
次数用完会怎样？会自动扣费吗？
不会自动扣费。次数用尽后接口返回 402，充值后立即可用；所有次数长期有效，不设过期时间。
支持查询哪些信息？包含 IPv6 吗？
支持 IPv4 与 IPv6，毫秒级返回国家、省份、城市、运营商，共 20+ 个字段：还包含是否中国大陆（is_china_mainland）、地区归类、大洲、国际电话区号（港澳台各自独立）、省/市行政区划码、省份拼音/简码/简称、国内大区、城市拼音/简码/电话区号，以及 ASN（自治系统号）与所属组织；另有批量接口，一次最多查询 100 个 IP，按命中条数计费。
港澳台 IP 的查询结果怎么显示？
香港、澳门、台湾统一返回 country=中国、country_code=CN，以 province 区分：香港特别行政区、澳门特别行政区、台湾省。同时提供 is_china_mainland（是否中国大陆）与 region（mainland/hk/mo/tw/overseas）字段，判断无需自己维护名单；电话区号也按地区区分（大陆 +86、香港 +852、澳门 +853、台湾 +886）。
AI 助手或编程 Agent 能直接接入吗？
可以。本站提供 MCP 远程端点（https://api.ip.denys.cn/mcp）与 AI 可读的完整接口说明（https://api.ip.denys.cn/llms-full.txt）：在 Claude Code / Cursor 等工具里加一行 MCP 配置即可调用；Agent 调用与人工调用同规则计费（按次、仅命中计费），注册赠送的 1,000 次足够完成试用与调试。
有调用频率限制吗？
有，默认每个 API Key 约 50 次/秒，超出返回 429，按业务并发量正常轮询不会触发；大批量场景建议改用批量接口合并请求。
API Key 泄露了怎么办？
在控制台可随时重置或禁用：重置后旧 Key 立即失效。每个账号最多可创建 50 个 Key，建议按开发/生产等环境分开管理。