IP 归属地查询 API，按次计费
支持 IPv4 与 IPv6，毫秒级返回国家、省市、运营商信息；单价低至 0.0004 元/次，次数长期有效，注册即送 1,000 次免费试用。
你的 IP 归属地（在线实时查询）
United States Ohio Columbus · Amazon
curl 'https://ip.denys.cn/v1/query?ip=216.73.216.71' -H 'X-API-Key: ipk_your_key'
毫秒级响应
IPv4/IPv6 均可查询，国家、省份、城市、运营商一次返回，结果稳定，适合业务侧长期缓存。
按次计费
仅查询命中（found=true）计费，单价低至 0.0004 元/次，次数长期有效，余额透明可查。
批量查询
POST 一次最多查询 100 个 IP，按命中个数计费。
AI 原生
提供 MCP 端点与 AI 可读文档，Claude Code、Cursor 等编程助手一行配置接入。
快速上手
curl 'https://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"
}curl 'https://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"
}常见问题
多少钱一次？
套餐单价低至 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，毫秒级返回国家、省份、城市、运营商等字段；另有批量接口，一次最多查询 100 个 IP，按命中条数计费。
港澳台 IP 的查询结果怎么显示？
香港、澳门、台湾统一返回 country=中国、country_code=CN，以 province 区分：香港特别行政区、澳门特别行政区、台湾省，city 字段为空；需要判断是否中国大陆时，用 province 不属于以上三个值即可。
AI 助手或编程 Agent 能直接接入吗？
可以。本站提供 MCP 远程端点（https://ip.denys.cn/mcp）与 AI 可读的完整接口说明（https://ip.denys.cn/llms-full.txt）：在 Claude Code / Cursor 等工具里加一行 MCP 配置即可调用；Agent 调用与人工调用同规则计费（按次、仅命中计费），注册赠送的 1,000 次足够完成试用与调试。
有调用频率限制吗？
有，默认每个 API Key 约 20 次/秒，超出返回 429，按业务并发量正常轮询不会触发；大批量场景建议改用批量接口合并请求。
API Key 泄露了怎么办？
在控制台可随时重置或禁用：重置后旧 Key 立即失效。每个账号最多可创建 50 个 Key，建议按开发/生产等环境分开管理。