Ваш IP адрес:
Провайдер:
...

Общая информация


Наш API создан как общедоступный ресурс для получения максимально полной информацией об IP-адресе пользователя. Данные предоставляются в форматах XML или JSON с использованием HTTP/HTTPS соединения. Информация в базах обновляется ежедневно и любой вебмастер может интегрировать данный сервис со своими проектами.

Наши API


Для интеграции данного сервиса со своими проектами мы предлагаем Вам один из следующих API:

  • сервис "Гео-IP API";
  • сервис "Провайдер-IP API";
  • сервис "Хостинг API";
  • сервис "MAC-адрес API";
  • сервис "Email API".

Ограничения в использовании


Лимит количества запросов к каждому из сервисов "Гео-IP API", "Провайдер-IP API", "Хостинг API", "MAC-адрес API" или "Email API" составляет не более 10 запросов с одного IP адреса на протяжении суток.

Формат данных


Данные предоставляемые нашими API содержащие следующие поля.

ip — проверяемый IP адрес;
country_code — 2-х символьный идентификатор страны по стандарту ISO 3166-1;
country — название страны на английском языке;
country_rus — название страны на русском языке;
country_ua — название страны на украинском языке;
region — название региона на английском языке;
region_rus — название региона на русском языке;
region_ua — название региона на украинском языке;
city — название населенного пункта (города) на английском языке;
city_rus — название населенного пункта (города) на русском языке;
city_ua — название населенного пункта (города) на украинском языке;
latitude — географическая широта;
longitude — географическая долгота;
ip — проверяемый IP адрес;
name_ripe — официальное название провайдера в базе данных Internet Routing Registry (IRR);
name_rus — название провайдера/бренд на русском;
site — сайт провайдера;
as — номер автономной системы провайдера;
ip_range_start — числовое значение (iptolong) первого IP адреса сети провайдера;
ip_range_end — числовое значение (iptolong) последнего IP адреса сети провайдера;
route — сеть провайдера;
mask — маска сети провайдера.
name_ripe — официальное название хостинг провайдера в базе данных Internet Routing Registry (IRR);
site — сайт хостинг провайдера;
company — название компании, которая зарегистрировала блок MAC-адресов;
address — полный адрес компании;
country — 2-х символьный идентификатор страны по стандарту ISO 3166-1;
private — за дополнительную плату поставщики могут скрывать свои данные. В этом случае для этого флага установлено значение «true», а company, address и country имеют значение «private»;
oui — уникальный идентификатор организации;
block_size — размер блока;
date_created — дата, когда диапазон был распределен;
date_updated — дата последнего обновления диапазона;
true — проверяемый email адрес существует;
false — проверяемый email адрес не существует;

Примеры запросов к API


IPv4:

IPv6:

Вызов 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>8.8.8.8</ip>
<country_code>US</country_code>
<country>United states</country>
<country_rus>США</country_rus>
<country_ua>США</country_ua>
<region>California</region>
<region_rus>Калифорния</region_rus>
<region_ua>Каліфорнія</region_ua>
<city>Mountain view</city>
<city_rus>Маунтин-Вью</city_rus>
<city_ua>Маунтін-Вью</city_ua>
<latitude>37.405992</latitude>
<longitude>-122.078515</longitude>
</geo_api>
{
"ip":"8.8.8.8",
"country_code":"US",
"country":"United states",
"country_rus":"\u0421\u0428\u0410\r",
"country_ua":"\u0423\u043a\u0440\u0430\u0457\u043d\u0430",
"region":"California",
"region_rus":"\u041a\u0430\u043b\u0438\u0444\u043e\u0440\u043d\u0438\u044f",
"region_ua":"\u041a\u0438\u0457\u0432\u0441\u044c\u043a\u0430 \u043e\u0431\u043b\u0430\u0441\u0442\u044c",
"city":"Mountain view",
"city_rus":"\u041c\u0430\u0443\u043d\u0442\u0438\u043d-\u0412\u044c\u044e",
"city_ua":"\u0411\u043e\u0440\u0438\u0441\u043f\u0456\u043b\u044c",
"latitude":"37.405992",
"longitude":"-122.078515",
}
<provider_api>
<ip>5.1.5.1</ip>
<name_ripe>PJSC "Datagroup"</name_ripe>
<name_rus>ЧАО "Датагруп"</name_rus>
<site>https://www.domtele.com/</site>
<as>21219</as>
<ip_range_start>83951616</ip_range_start>
<ip_range_end>83959807</ip_range_end>
<route>5.1.0.0</route>
<mask>19</mask>
</provider_api>
{
"ip":"5.1.5.1",
"name_ripe":"PJSC \"Datagroup\"",
"name_rus":"\u0427\u0410\u041e \"\u0414\u0430\u0442\u0430\u0433\u0440\u0443\u043f\"",
"site":"http:\/\/www.domtele.com\/",
"as":"21219",
"ip_range_start":"83951616",
"ip_range_end":"83959807",
"route":"5.1.0.0",
"mask":"19"
}
<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"]
}
}

Модуль для Python


Мы разработали модуль для Python, который очень лего установить и сразу приступить к ипользованию API.

Install the module from PyPI:

python3 -m pip install 2ip

Retrieve provider information for the IP address 192.0.2.0 as a dict:

>>> from twoip import TwoIP
>>> twoip = TwoIP(key = None)
>>> twoip.provider(ip = '192.0.2.0')
{'ip': '192.0.2.0',
 'ip_range_end': '3221226239',
 'ip_range_start': '3221225984',
 'mask': '24',
 'name_ripe': 'Reserved AS',
 'name_rus': '',
 'route': '192.0.2.0'}

Retrieve geographic information for the IP address 8.8.8.8 as a dict:

>>> from twoip import TwoIP
>>> twoip = TwoIP(key = None)
>>> twoip.geo(ip = '8.8.8.8')
{'city': 'Mountain view',
 'country': 'United states of america',
 'country_code': 'US',
 'country_rus': 'США',
 'country_ua': 'США',
 'ip': '8.8.8.8',
 'latitude': '37.405992',
 'longitude': '-122.078515',
 'region': 'California',
 'region_rus': 'Калифорния',
 'region_ua': 'Каліфорнія''}

More information here: https://pypi.org/project/2ip/

Стоимость


10 запросов в день — бесплатно (кроме Email API, для него только 2 запроса в день бесплатно).

1000 запросов в день к нашей базе, на протяжении 30 календарных дней, стоят 10$. Каждая последующая тысяча стоит + 1$. Например, если вам нужно 5000 запросов в день, то это будет стоить 14$ за месяц.

Безлимит — 100$ в месяц (но не больше 1 миллиона обращений в день).

После оплаты вы получите письмо с инструкцией и Вашим персональным "API ключем". Лимит будет привязан к нему.

Получить более подробную информацию Вы можете или обращайтесь по адресу [email protected].