Наши API

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

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

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

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

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

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

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

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

Сервис "Гео-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 API":

ip — проверяемый IP адрес;

name_ripe — официальное название провайдера в базе данных Internet Routing Registry (IRR);

name_rus — название провайдера/бренд на русском;

site — сайт провайдера;

as — номер автономной системы провайдера;

ip_range_start — числовое значение (iptolong) первого IP адреса сети провайдера;

ip_range_end — числовое значение (iptolong) последнего IP адреса сети провайдера;

route — сеть провайдера;

mask — маска сети провайдера.

Сервис "Proxy-IP API":

ip — проверяемый IP адрес;

if_this_proxy_ip — признак наличия IP адреса в базе proxy: yes или no;

ip_from — числовое значение первого IP адреса proxy-диапазона;

ip_to — числовое значение последнего IP адреса proxy-диапазона;

proxy_type — тип proxy;

country_code — 2-символьный код страны;

country_name — название страны;

region_name — название региона;

city_name — название города;

isp — провайдер или владелец сети;

domain — домен, связанный с IP адресом;

usage_type — тип использования сети;

asn — номер автономной системы;

as — название автономной системы;

last_seen — количество дней с момента последнего обнаружения;

threat — известные угрозы или признаки нежелательной активности;

provider — поставщик данных о proxy;

message — пояснение для IP адреса, который не найден в базе proxy.

Сервис "Хостинг API":

name_ripe — официальное название хостинг провайдера в базе данных Internet Routing Registry (IRR);

site — сайт хостинг провайдера;

Сервис "MAC-адрес API":

company — название компании, которая зарегистрировала блок MAC-адресов;

address — полный адрес компании;

country — 2-х символьный идентификатор страны по стандарту ISO 3166-1;

private — за дополнительную плату поставщики могут скрывать свои данные. В этом случае для этого флага установлено значение «true», а company, address и country имеют значение «private»;

oui — уникальный идентификатор организации;

block_size — размер блока;

date_created — дата, когда диапазон был распределен;

date_updated — дата последнего обновления диапазона;

Сервис "Email API":

true — проверяемый email адрес существует;

false — проверяемый email адрес не существует;

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

Пример XML и JSON запросов к сервису "Гео-IP API":

IPv4:

IPv6:

Вызов API с пустым параметром "ip" вернет информацию об IP адресе, с которого происходит обращение.

XML: https://api.2ip.ua/geo.xml?ip=
JSON: https://api.2ip.ua/geo.json?ip=

Пример XML и JSON запросов к сервису "Провайдер-IP API":

IPv4:

Вызов API с пустым параметром "ip" вернет информацию об IP адресе, с которого происходит обращение.

XML: https://api.2ip.ua/provider.xml?ip=
JSON: https://api.2ip.ua/provider.json?ip=

Пример XML и JSON запросов к сервису "Proxy-IP API":

IPv4:

Вызов API с пустым параметром "ip" вернет информацию об IP адресе, с которого происходит обращение.

XML: https://api.2ip.ua/proxy.xml?ip=
JSON: https://api.2ip.ua/proxy.json?ip=

Пример XML и JSON запросов к сервису "Хостинг API":

Пример XML и JSON запросов к сервису "MAC-адрес API":

Формат MAC-адреса для проверки может быть один из следующих:

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

Пример XML и JSON запросов к сервису "Email API":

XML: https://api.2ip.ua/[email protected]
JSON: https://api.2ip.ua/[email protected]

Примеры ответа

Пример XML ответа сервиса "Гео-IP API":

<geo_api>

<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>

</geo_api>

Пример JSON ответа сервиса "Гео-IP 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",

}

Пример XML ответа сервиса "Провайдер-IP API":

<provider_api>

<name_ripe>Baykov Ilya Sergeevich</name_ripe>

<name_ua></name_ua>

<name_rus></name_rus>

<site>http://www.zaoipnet.ru/</site>

<ip_range_start>764187392</ip_range_start>

<ip_range_end>764187647</ip_range_end>

</provider_api>

Пример JSON ответа сервиса "Провайдер-IP 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"

}

Пример XML ответа сервиса "Proxy-IP API":

<proxy_api>

<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>

<as>Baykov Ilya Sergeevich</as>

<last_seen>30</last_seen>

<threat>SPAM/SCANNER/BOTNET</threat>

</proxy_api>

Пример JSON ответа сервиса "Proxy-IP 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":"-"

}

Пример XML ответа сервиса "Хостинг API":

<hosting_api>

<name_ripe>Google Inc.</name_ripe>

<site>https://www.google.com/</site>

</hosting_api>

Пример JSON ответа сервиса "Хостинг API":

{

"name_ripe":"Google Inc."

"site":"https:\/\/www.google.com\/"

}

Пример XML ответа сервиса "MAC-адрес API":

<company>Super Micro Computer, Inc</company>

<address>2051 Junction Avenue San Jose CA 95131 US</address>

<block_size>MA-L</block_size>

<date_created>2000-11-09</date_created>

<date_updated>2015-09-27</date_updated>

</macVendor>

Пример JSON ответа сервиса "MAC-адрес API":

{

"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"

}

Пример XML ответа сервиса "Email API":

true / false

Пример JSON ответа сервиса "Email API":

{

"exist":true,

"detail":{

"[email protected]":true,

"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 45.140.147.155 as a dict:

>>> from twoip import TwoIP
>>> twoip = TwoIP(key = None)
>>> twoip.geo(ip = '45.140.147.155')
{'city': 'Mountain view',
 'country': 'United states of america',
 'country_code': 'US',
 'country_rus': 'США',
 'country_ua': 'США',
 'ip': '45.140.147.155',
 '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].