IP/域名查询API收费

IP/域名查询归属地 · 最后更新：2026-09-03

🧪 在线调试

GET https://ip258.cn/vip/ip.php

等待发送请求…

📖 快速调用

依托本地部署的IP数据库，实现秒级响应的查询体验，全面支持位置查询等核心场景

🔗 接口信息

接口地址	https://ip258.cn/vip/ip.php
请求方式	GET，支持跨域
数据格式	JSON（UTF-8）
支持类型	IPv4 / IPv6
计费方式	需KEY授权码
数据缓存	相同 IP 结果缓存 2 小时

💰 套餐介绍

IP/域名查询归属地包月套餐

9.9元

额度：不限次限流：30次/秒时长：31天

ip查询精准版可定位到县

IP/域名查询归属地包年套餐

120元

额度：不限次限流：50次/秒时长：365天

ip查询精准版可定位到县

0元购

额度：每天500次限流：3次/秒时长：永久

ip查询精准版可定位到县

📥 请求参数

参数	必填	类型	说明
`ip`	可选	string	ipv4/ipv6/域名；不传默认返回本机公网IP
`key`	必填	string	您的授权 Key，在会员中心获取

📤 返回示例

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "input": "42.202.46.103",
    "ip": "42.202.46.103",
    "ip_version": "IPv4",
    "ip_type": "ISP",
    "domain_parse_msg": "",
    "country": "中国",
    "province": "辽宁省",
    "city": "鞍山市岫岩满族自治县岫岩满族自治县",
    "district": "岫岩满族自治县",
    "isp": "中国电信",
    "lng": "123.333827",
    "lat": "40.395457",
    "big_area": "东北",
    "continent": "亚洲",
    "call_stats": {
      "used_day": 104,
      "remaining_day": "不限",
      "tips": "小时调用次数暂不统计"
    },
    "used_api": "ip258.cn-IP库",
    "adcode": "210323",
    "timezone": "UTC+8",
    "asnumber": "4134",
    "radius": "50.5185",
    "zip_code": "114300",
    "country_code": "CN",
    "long_ip": "717893223"
  },
  "tried_apis": [
    {
      "api_name": "ip258.cn本地缓存",
      "status": "成功",
      "error_msg": "无"
    }
  ]
}

🗂 data 字段说明

字段	类型	说明
`code`	string	200=成功,401=未授权,404=域名解析失败,429=频率超限,500=异常
`msg`	string	状态描述文本
`tried_apis`	string	查询链路追踪，单条包含api_name接口名称、status状态、error_msg错误备注
`input`	string	用户原始输入内容（IP/域名）
`ip`	string	最终解析后的查询IP
`ip_version`	string	IP版本：IPv4 / IPv6
`ip_type`	string	网络类型；可选值[ISP：家庭用户] [BUS：企业专线] [IDC：机房/数据中心] MOBILE(手机/wifi基站)；IPv6无此数据返回空字符串
`domain_parse_msg`	string	域名解析备注，直接输入IP时为空字符串
`country`	string	国家名称
`province`	string	省份
`city`	string	城市+区县合并完整名称
`district`	string	区县名称
`isp`	string	网络运营商
`lng`	string	WGS84经度
`lat`	string	WGS84纬度
`continent`	string	大洲（亚洲/欧洲/北美洲等）
`big_area`	string	国内七大行政大区（华北/华东/华南等）
`zip_code`	string	邮政编码，无数据返回空字符串
`country_code`	string	两位国家简码
`adcode`	string	行政区划标准AD编码，无数据返回空
`timezone`	string	时区标识，无数据返回空
`asnumber`	string	网络AS自治域编号，无数据返回空
`radius`	string	定位精度半径，无数据返回空
`long_ip`	string	IPv4数字长整型，IPv6为空
`city_code`	string	城市标准编码，无数据返回空
`city_short_code`	string	城市简码，无数据返回空
`area_code`	string	区县区域编码，无数据返回空
`used_api`	string	数据源标识：ip258‑IP库

💻 代码示例

# 查询指定 IP（支持 IPv4 / IPv6）
curl -G "https://ip258.cn/vip/api.php" \
  --data-urlencode "key=你的正式授权码" \
  --data-urlencode "ip=240a:42cd:5c00:e03::1" \
  -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"

# 也可直接拼在 URL 上（两种写法等价）
# curl "https://ip258.cn/vip/api.php?key=你的正式授权码&ip=240a:42cd:5c00:e03::1" -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"

$apiKey = "你的正式授权码"; // 在会员中心获取
$ip = "240a:42cd:5c00:e03::1"; // 要查询的IP（IPv4/IPv6）
$url = "https://ip258.cn/vip/api.php?key=" . urlencode($apiKey) . "&ip=" . urlencode($ip);
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_USERAGENT => 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
    CURLOPT_TIMEOUT => 10,
]);
$res = curl_exec($ch);
curl_close($ch);
// $res 包含全部data下字段：ip_version、ip_type、province、country_code、asnumber、timezone等
echo $res;

async function queryVipIp(apiKey, ip) {
  const url = 'https://ip258.cn/vip/api.php?key=' + encodeURIComponent(apiKey) + '&ip=' + encodeURIComponent(ip);
  const res = await fetch(url);
  const data = await res.json();
  if (data.code !== 200) throw new Error('[' + data.code + '] ' + (data.msg || '查询失败'));
  return data.data; // 含 ip_version、ip_type、province、country_code、asnumber、timezone 等字段
}

// 使用示例
queryVipIp('你的正式授权码', '240a:42cd:5c00:e03::1')
  .then(d => console.log('查询成功：', d.province, d.ip_type, d.asnumber))
  .catch(e => console.error(e.message));

import requests

def query_vip_ip(api_key, ip):
    url = 'https://ip258.cn/vip/api.php'
    params = {'key': api_key, 'ip': ip}
    headers = {
        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'
    }
    r = requests.get(url, params=params, headers=headers, timeout=10)
    d = r.json()
    if d.get('code') != 200:
        raise Exception('[' + str(d.get('code')) + '] ' + str(d.get('msg', '查询失败')))
    return d['data']  # 含 ip_version、ip_type、province、country_code、asnumber、timezone 等字段

print(query_vip_ip('你的正式授权码', '240a:42cd:5c00:e03::1'))

🚦 状态码

code	含义	处理
`200`	查询成功，返回完整IP归属数据	直接取 data 使用
`404`	域名DNS解析失败，无法转换成有效IP地址	检查参数格式
`401`	缺少key参数、API授权码无效/过期	填写正确key
`429`	请求过于频繁：①单IP一分钟超限次	降速后重试
`500`	数据库连接失败、三方IP数据源请求异常、数据解析失败	稍后重试，无需改代码
`403`	授权码已到期/额度已用尽	续费套餐

⏱ 频率限制

🆓 免费接口限流

规则	说明
基础频率	每 Key 每分钟 60 次
瞬时脉冲	每 Key 每秒 3 次（QPS）
每日限量	每天500次

💰 收费接口限流

规则	说明
瞬时脉冲	30次/秒 \| 50次/秒
每日限量	不限量

❓ 常见问题

问题	原因 & 解决
查询 IPv6 邮编、区号为空？	正常。IPv6 上游数据部分字段为空，以实际返回为准。

📅 版本记录

版本	日期	说明
v1.0	2026-09-02	初版