您的 IPv4 地址:
操作系统:
运营商:

基本信息

我们的 API 是一项公共资源,用于获取有关用户 IP 地址的最完整信息。数据格式为 XML 或 JSON,通过 HTTP/HTTPS 连接获取。数据库中的信息每天更新,每位网站管理员都可以将此服务集成到自己的项目中。

我们的 API

为了将我们的服务集成到您的项目中,我们为您提供以下 API 之一:

  • “Geo-IP API”服务;
  • “Provider-IP API”服务。
  • “Proxy-IP API”服务。
  • “Hosting API”服务;
  • “MAC-address API”服务;
  • “Email API”服务。

使用限制

Geo-IP API、Provider-IP API、Proxy-IP API、Hosting API、MAC-address API 和 Email API 各项服务均允许每个 IP 地址每天最多发送 2 次免费请求。

数据格式

我们的 API 提供的数据包含以下字段。

ip — 所查询的 IP 地址;
country_code — 2 个字符的国家/地区代码;
country — 英文国家/地区名称;
country_rus — 俄文国家/地区名称;
country_ua — 乌克兰文国家/地区名称;
region — 英文地区名称;
region_rus — 俄文地区名称;
region_ua — 乌克兰文地区名称;
city — 英文城市名称;
city_rus — 俄文城市名称;
city_ua — 乌克兰文城市名称;
latitude — 纬度;
longitude — 经度;
ip — 所查询的 IP 地址;
name_ripe — 运营商在互联网路由注册(IRR)数据库中的正式名称;
name_rus — 运营商的俄文名称/品牌;
site — 运营商网站;
as — 运营商的 AS(自治系统);
ip_range_start — 运营商网络第一个 IP 地址的数值(iptolong);
ip_range_end — 运营商网络最后一个 IP 地址的数值(iptolong);
route — 网络;
mask — 子网掩码。
ip — 所查询的 IP 地址;
if_this_proxy_ip — 该 IP 地址是否列于代理数据库中:yes 或 no;
ip_from — 代理地址段中第一个 IP 地址的数值;
ip_to — 代理地址段中最后一个 IP 地址的数值;
proxy_type — 代理类型;
country_code — 2 个字符的国家/地区代码;
country_name — 国家/地区名称;
region_name — 地区名称;
city_name — 城市名称;
isp — 网络运营商或所有者;
domain — 与该 IP 地址关联的域名;
usage_type — 网络使用类型;
asn — 自治系统编号;
as — 自治系统名称;
last_seen — 自上次检测到以来的天数;
threat — 已知威胁或不良活动指标;
provider — 代理数据提供方;
message — 针对未列于代理数据库中的 IP 地址的说明。
name_ripe — 托管服务商在互联网路由注册(IRR)数据库中的正式名称;
site — 托管服务商网站;
company — 注册该 MAC 地址块的公司名称;
address — 公司完整地址;
country — 符合 ISO 3166-1 标准的 2 个字符的国家/地区代码;
private — 供应商可支付额外费用以隐藏其数据。在这种情况下,该标志设置为 true,company、address 和 country 设置为«private»;
oui — 组织唯一标识符;
block_size — 地址块大小;
date_created — 该地址段的分配日期;
date_updated — 该地址段的最后更新日期;
true — 所查询的电子邮件地址存在;
false — 所查询的电子邮件地址不存在;

API 请求示例

IPv4:

如果调用 API 时参数“ip”为空,将返回发出请求的 IP 地址的信息。

IPv4:

如果调用 API 时参数“ip”为空,将返回发出请求的 IP 地址的信息。

用于查询的 MAC 地址可以采用以下任一格式:

  • 00:30:48:5a:58:65
  • 00-22-15-75-1C-1E
  • 000a.e475.7469
  • 001201BB4ADD

响应示例

<geo_api>
<ip>45.140.147.155</ip>
<country_code>FR</country_code>
<country>France</country>
<country_rus>Франция</country_rus>
<country_ua>Франція</country_ua>
<region>Ile-de-france</region>
<region_rus>Иль-де-Франс</region_rus>
<region_ua>Іль-де-Франс</region_ua>
<city>Paris</city>
<city_rus>Париж</city_rus>
<city_ua>Маунтін-Вью</city_ua>
<latitude>48.859078</latitude>
<longitude>2.293486</longitude>
</geo_api>
{
"ip":"45.140.147.155",
"country_code":"FR",
"country":"France",
"country_rus":"\u0424\u0440\u0430\u043d\u0446\u0438\u044f",
"country_ua":"\u0424\u0440\u0430\u043d\u0446\u0456\u044f",
"region":"Ile-de-france",
"region_rus":"\u0418\u043b\u044c-\u0434\u0435-\u0424\u0440\u0430\u043d\u0441",
"region_ua":"\u0406\u043b\u044c-\u0434\u0435-\u0424\u0440\u0430\u043d\u0441",
"city":"Paris",
"city_rus":"\u041f\u0430\u0440\u0438\u0436",
"city_ua":"\u041f\u0430\u0440\u0456\u0436",
"latitude":"48.859078",
"longitude":"2.293486",
}
<provider_api>
<ip>45.140.147.155</ip>
<name_ripe>Baykov Ilya Sergeevich</name_ripe>
<name_ua></name_ua>
<name_rus></name_rus>
<site>http://www.zaoipnet.ru/</site>
<as>41745</as>
<ip_range_start>764187392</ip_range_start>
<ip_range_end>764187647</ip_range_end>
<route></route>
<mask>24</mask>
</provider_api>
{
"ip":"45.140.147.155",
"name_ripe":"Baykov Ilya Sergeevich",
"name_ua":"",
"name_rus":"",
"site":"http:\/\/www.zaoipnet.ru\/",
"as":"41745",
"ip_range_start":"764187392",
"ip_range_end":"764187647",
"route":"",
"mask":"24"
}
<proxy_api>
<ip>45.140.147.155</ip>
<if_this_proxy_ip>yes</if_this_proxy_ip>
<ip_from>764187547</ip_from>
<ip_to>764187547</ip_to>
<proxy_type>PUB</proxy_type>
<country_code>FR</country_code>
<country_name>France</country_name>
<region_name>Ile-de-France</region_name>
<city_name>Paris</city_name>
<isp>Baykov Ilya Sergeevich</isp>
<domain>hip-hosting.com</domain>
<usage_type>DCH</usage_type>
<asn>41745</asn>
<as>Baykov Ilya Sergeevich</as>
<last_seen>30</last_seen>
<threat>SPAM/SCANNER/BOTNET</threat>
<provider>-</provider>
</proxy_api>
{
"ip":"45.140.147.155",
"if_this_proxy_ip":"yes",
"ip_from":"764187547",
"ip_to":"764187547",
"proxy_type":"PUB",
"country_code":"FR",
"country_name":"France",
"region_name":"Ile-de-France",
"city_name":"Paris",
"isp":"Baykov Ilya Sergeevich",
"domain":"hip-hosting.com",
"usage_type":"DCH",
"asn":"41745",
"as":"Baykov Ilya Sergeevich",
"last_seen":"30",
"threat":"SPAM\/SCANNER\/BOTNET",
"provider":"-"
}
<hosting_api>
<name_ripe>Google Inc.</name_ripe>
<site>https://www.google.com/</site>
</hosting_api>
{
"name_ripe":"Google Inc."
"site":"https:\/\/www.google.com\/"
}
<macVendor>
<company>Super Micro Computer, Inc</company>
<address>2051 Junction Avenue San Jose CA 95131 US</address>
<country>US</country>
<private>0</private>
<oui>00:30:48</oui>
<block_size>MA-L</block_size>
<date_created>2000-11-09</date_created>
<date_updated>2015-09-27</date_updated>
</macVendor>
{
"company":"Super Micro Computer, Inc",
"address":"2051 Junction Avenue San Jose CA 95131 US",
"country":"US",
"private":"0",
"oui":"00:30:48",
"block_size":"MA-L",
"date_created":"2000-11-09",
"date_updated":"2015-09-27"
}
true / false
{
"exist":true,
"detail":{
"domains":{
"google.com":{
"users":["admin"],
"mxs":{
"aspmx.l.google.com":10,
"alt1.aspmx.l.google.com":20,
"alt2.aspmx.l.google.com":30,
"alt3.aspmx.l.google.com":40,
"alt4.aspmx.l.google.com":50,
"google.com":0
}
}
},
"log":[
"[2019-02-13T19:26:56.533234+0000] Connecting to aspmx.l.google.com:25",
"[2019-02-13T19:26:56.566308+0000] Connected to aspmx.l.google.com:25 successfully",
"[2019-02-13T19:26:56.600374+0000] <<<recv: 220 mx.google.com ESMTP u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.600473+0000] send>>>: EHLO 2ip.ua",
"[2019-02-13T19:26:56.637390+0000] <<<recv: 250-mx.google.com at your service, [77.123.139.187]\r\n",
"[2019-02-13T19:26:56.637419+0000] <<<recv: 250-SIZE 157286400\r\n",
"[2019-02-13T19:26:56.637426+0000] <<<recv: 250-8BITMIME\r\n",
"[2019-02-13T19:26:56.637430+0000] <<<recv: 250-STARTTLS\r\n",
"[2019-02-13T19:26:56.637434+0000] <<<recv: 250-ENHANCEDSTATUSCODES\r\n",
"[2019-02-13T19:26:56.637438+0000] <<<recv: 250-PIPELINING\r\n",
"[2019-02-13T19:26:56.637442+0000] <<<recv: 250-CHUNKING\r\n",
"[2019-02-13T19:26:56.637445+0000] <<<recv: 250 SMTPUTF8\r\n",
"[2019-02-13T19:26:56.637457+0000] send>>>: MAIL FROM:<[email protected]>",
"[2019-02-13T19:26:56.670259+0000] <<<recv: 250 2.1.0 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.670292+0000] send>>>: NOOP",
"[2019-02-13T19:26:56.703219+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.703253+0000] send>>>: NOOP",
"[2019-02-13T19:26:56.736009+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.736052+0000] send>>>: RCPT TO:<[email protected]>",
"[2019-02-13T19:26:56.985345+0000] <<<recv: 250 2.1.5 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:56.985377+0000] send>>>: NOOP",
"[2019-02-13T19:26:57.018204+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:57.018236+0000] send>>>: RSET",
"[2019-02-13T19:26:57.051533+0000] <<<recv: 250 2.1.5 Flushed u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:57.051576+0000] send>>>: QUIT",
"[2019-02-13T19:26:57.084687+0000] <<<recv: 221 2.0.0 closing connection u13-v6si69438lju.221 - gsmtp\r\n",
"[2019-02-13T19:26:57.084761+0000] Closing socket to aspmx.l.google.com:25"]
}
}

价格

每个适用的 API 均允许每个 IP 地址每天发送 2 次免费请求。

每天向我们的数据库发送 1000 次请求,30 天的费用为 10$。每增加一千次请求加收 1$。例如,如果您每天需要 5000 次请求,每月费用为 14$。

不限请求次数 — 每月 100$(但每天调用次数不超过 100 万次)。

付款后,您将收到一封包含使用说明和您的个人“API 密钥”的电子邮件。限额将与该密钥绑定。

您可以以获取更详细的信息,或通过以下地址联系我们:[email protected]。