Developer docs

API 接口文档

通过 HTTP GET 请求查询 IP 归属地、ASN、VPN 等信息

接口概览

我们的 API 接口提供 IP 地址归属地查询服务,支持 IPv4 和 IPv6,返回格式为 JSON。

请求地址

GET
https://ipv46.upx8.com/api/?ip=222.137.21.199

请求参数

ip 需要查询的 IP 地址 必填
format 返回格式,可选,默认 JSON
返回示例
{
  "ip": "222.137.21.199",
  "ip_version": "IPv4",
  "as": {
    "number": 4837,
    "name": "CHINA UNICOM China169 Backbone",
    "info": "中国联通"
  },
  "addr": "222.137.21.0/24",
  "timezone": "Asia/Shanghai",
  "coordinates": { "latitude": 34.7599, "longitude": 113.6459 },
  "country": { "code": "CN", "name": "中国" },
  "is_vpn": false,
  "regions": ["河南省", "郑州市", "二七区"],
  "regions_short": ["河南", "郑州", "二七区"],
  "postal_code": "450000"
}
cURL 示例
curl -X GET "https://ipv46.upx8.com/api/?ip=123.45.67.89"
PHP 示例
<?php
$ip  = '123.45.67.89';
$url = "https://ipv46.upx8.com/api/?ip={$ip}";
$res = json_decode(file_get_contents($url), true);
echo $res['country']['name'];  // 中国
echo $res['as']['info'];       // 中国联通
?>
JavaScript 示例
const ip  = '123.45.67.89';
const res = await fetch(`https://ipv46.upx8.com/api/?ip=${ip}`);
const data = await res.json();
console.log(data.country.name); // 中国
console.log(data.as.info);      // 中国联通
Python 示例
import requests

ip   = '123.45.67.89'
data = requests.get(f'https://ipv46.upx8.com/api/?ip={ip}').json()
print(data['country']['name'])  # 中国
print(data['as']['info'])       # 中国联通