IP 地址查询

查询 IP 对应的省市区、运营商、邮编和区号，兼容 IPv4 / IPv6

查询 IPv4 / IPv6 对应的国家、省市区、运营商、邮编和区号。

【怎么调用】
1. 请求地址：本页顶部的调用地址
2. 请求方法：GET
3. 把个人中心的 API Key 放到请求头 X-API-Key，不要写进网址
4. 要查的 IP 作为网址参数：?ip=39.130.123.192

【Query 参数】
ip：要查询的 IP，可选。不传则查当前请求方 IP
datatype：返回格式，可选 jsonp / xml / txt，推荐 jsonp（返回 JSON）

【返回说明】
ret：ok 成功，err 失败
ip：实际查询的 IP
data：成功时的结果数组，依次为国家、省份、城市、区县、运营商、邮编、区号、网络类型
msg：失败时的错误信息

调用地址：https://api.ynlskj.com.cn/gateway/ip-query

请求方法：GET

在其他地方怎么调用

请求地址用上面的调用地址，参数拼在网址后面，例如 ?ip=39.130.123.192
方法用 GET
API Key 只能放在请求头 X-API-Key，不要写进网址，也不要写进 Query 框
Key 在「个人中心 → API Key」里复制，登录后会自动填入你自己的 Key

参数说明

参数	位置	必填	说明
`ip`	Query	否	要查询的 IP。不传则查询当前请求方 IP
`datatype`	Query	否	jsonp（推荐，返回 JSON）/ xml / txt
`X-API-Key`	Header	是	你的 API Key（请求头，不要放进网址或 Query）

返回说明

字段	说明
`ret`	`ok` 成功，`err` 失败
`ip`	实际查询的 IP
`data`	成功时的数组，依次为：国家、省份、城市、区县、运营商、邮编、区号、网络类型
`msg`	本站提示，如「次数充足，剩余 99 次」或「次数不足，剩余 0 次」
`remain_quota`	本次调用后的剩余次数

可直接复制的代码

未登录时示例只显示「你的密钥」。登录后会自动填入你自己的 Key，不会展示别人的。

<?php
$ch = curl_init('https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: 你的密钥'],
]);
echo curl_exec($ch);

import requests

url = 'https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192'
headers = {'X-API-Key': '你的密钥'}
resp = requests.get(url, headers=headers, timeout=15)
print(resp.text)

package main

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

func main() {
	req, _ := http.NewRequest("GET", "https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192", nil)
	req.Header.Set("X-API-Key", "你的密钥")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

fetch('https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192', {
  method: 'GET',
  headers: {
    'X-API-Key': '你的密钥'
  }
})
  .then(res => res.json())
  .then(data => console.log(data));

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192"))
    .header("X-API-Key", "你的密钥")
    .GET()
    .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "你的密钥");
var result = await client.GetStringAsync("https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192");
Console.WriteLine(result);

curl -X GET "https://api.ynlskj.com.cn/gateway/ip-query?ip=39.130.123.192" \
  -H "X-API-Key: 你的密钥"

请求参数演示

{
  "ip": "39.130.123.192"
}

响应演示

{
  "ret": "ok",
  "ip": "39.130.123.192",
  "data": [
    "中国",
    "云南",
    "昆明",
    "官渡",
    "移动",
    "650200",
    "0871",
    "城域网"
  ],
  "msg": "次数充足，剩余 99999 次",
  "remain_quota": 99999
}

在线调试

登录后可在线调试。调试会真实调用网关并消耗次数。

去登录