IP 地址查询（街道级） API 接入文档ip-pro

本接口默认开放匿名调用（受每日免费额度限制）。需要更高配额或商业使用时，请携带 Authorization 头。

获取 API Key：登录 https://apizero.cn/account/keys

以下 5 种语言示例都是可直接运行的，只需把 YOUR_API_KEY 替换为实际 Key。

curl "https://v1.apizero.cn/api/ip-pro?ip=110.87.41.14&key=YOUR_API_KEY"

import requests

resp = requests.get(
    "https://v1.apizero.cn/api/ip-pro",
    params={
    "ip": "110.87.41.14",
    "key": "YOUR_API_KEY",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())

// Node.js 18+ / 浏览器原生 fetch
const params = new URLSearchParams({
  "ip": "110.87.41.14",
  "key": "YOUR_API_KEY",
});

const res = await fetch(`https://v1.apizero.cn/api/ip-pro?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://v1.apizero.cn/api/ip-pro", nil)
	q := req.URL.Query()
	q.Set("ip", "110.87.41.14")
	q.Set("key", "YOUR_API_KEY")
	req.URL.RawQuery = q.Encode()

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

<?php
$url = "https://v1.apizero.cn/api/ip-pro?" . http_build_query([
    "ip" => "110.87.41.14",
    "key" => "YOUR_API_KEY",
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 15);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);

{
    "code": 0,
    "msg": "成功",
    "data": {
        "ip": "117.25.49.203",
        "continent": "亚洲",
        "country": "中国",
        "country_code": "CN",
        "province": "福建",
        "city": "福州",
        "district": "永泰",
        "street": "城峰镇",
        "street_alternatives": [
            "福建福州永泰城峰镇",
            "福建福州永泰大洋镇"
        ],
        "area_code": "350125",
        "zip_code": "350000",
        "city_code": "0591",
        "latitude": 25.855039,
        "longitude": 118.94202,
        "elevation": 29,
        "time_zone": "Asia\/Shanghai",
        "isp": "电信",
        "risk": {
            "level": "无风险",
            "score": 0,
            "is_proxy": false,
            "proxy_probability": 0,
            "real_rate": 6,
            "mobile_rate": 4.69
        },
        "source": "primary"
    },
    "request_id": "abc123"
}

• 1.1.0(2026-05-28)
  • 重构上游链路，大幅提升查询成功率和稳定性
  • 引入备用数据源，主数据源不可用时自动降级到城市级信息
  • 响应新增 data.source 字段：primary = 街道级 + 风险评分；backup = 城市级基础信息
  • 缓存策略：主数据源命中缓存 12h、备用数据源命中缓存 1h（更快尝试主源恢复）
• 1.0.0(2026-05-04)
  • 首次发布
  • 支持 IPv4 / IPv6 街道级归属查询
  • 返回 25+ 标准化字段（含完整风险评分）
  • 12 小时边缘缓存