IP 归属地查询

输入 IPv4 地址，返回国家、地区、城市、时区与运营商等归属信息。

无需鉴权 · 超时 15s

GET https://www.deeapi.com/wp-json/apihub/v1/call/6

免费接口：在线调试与程序调用均须填写/携带站点 Key 后使用，不提供匿名试用。Key 在「我的控制台」获取。

接口说明

### 说明
– 免费额度有限，站点已开启 **10 分钟** 结果缓存，重复查询不消耗上游额度。
– 传入非法 IP 时上游会返回 `{“error”: true}`，属于正常业务返回。

调用统计

0 累计调用

0 今日调用

0% 成功率

0ms 平均耗时

近 30 天调用趋势

10/1510/3011/13

请求参数共 1 个

参数名	必填	默认值	说明
`ip` PATH · string	必填	`8.8.8.8`	要查询的 IPv4 地址

鉴权参数： 在线调试与程序调用均必须携带站点 Key，以 key 参数传入（Query 或 POST 字段均可），例如 ?key=ah_xxxxxxxx。 Key 在「我的控制台」获取，切勿写进前端代码或提交到公开仓库。

调用示例

BASH

curl -X GET "https://www.deeapi.com/wp-json/apihub/v1/call/6?key=YOUR_SITE_KEY" \
  -H "Accept: application/json"

PHP

<?php
$url = 'https://www.deeapi.com/wp-json/apihub/v1/call/6?key=YOUR_SITE_KEY';

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 20,
    CURLOPT_HTTPHEADER     => ['Accept: application/json'],
]);
$response = curl_exec($ch);
curl_close($ch);

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

JAVASCRIPT

const params = {"key":"YOUR_SITE_KEY"};
const url = 'https://www.deeapi.com/wp-json/apihub/v1/call/6?' + new URLSearchParams(params);

const res = await fetch(url, {
  method: 'GET',
  headers: { 'Accept': 'application/json' }
});

const data = await res.json();
console.log(data);

PYTHON

import requests

url = "https://www.deeapi.com/wp-json/apihub/v1/call/6"
params = {
    "key": "YOUR_SITE_KEY",
}

resp = requests.get(url, params=params, timeout=20)
print(resp.json())

返回示例

网关会统一包装返回结果，业务数据在 data 字段内：

JSON

{
  "ok": true,
  "http_code": 200,
  "cost_ms": 186,
  "credits": 0,
  "currency": "points",
  "cached": false,
  "data": {
  "ip": "8.8.8.8",
  "city": "Mountain View",
  "region": "California",
  "country_name": "United States",
  "org": "GOOGLE",
  "timezone": "America/Los_Angeles"
}
}

补充说明

说明

免费额度有限，站点已开启 10 分钟 结果缓存，重复查询不消耗上游额度。
传入非法 IP 时上游会返回 {"error": true}，属于正常业务返回。

网关错误码

HTTP	code	说明
400	`missing_param`	缺少必填参数，message 中会给出参数名
401	`invalid_key / need_login`	站点 Key 无效或未登录
402	`no_balance`	余额或积分不足，请充值后再调用
404	`api_not_found`	接口不存在或已下线
429	`rate_limited`	超出今日调用频率上限
502	`upstream_error`	接口服务不可达或响应异常，本次不扣费