2IP API | 2IP.ua

Загальна інформація

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

Наші API

Для інтеграції даного сервісу зі своїми проектами, ми пропонуємо Вам один з наступних API:

cервіс "Гео-IP API";
cервіс "Провайдер-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 — маска мережі провайдера.

Сервіс "Хостинг 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 запитів до сервісу "Хостинг 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>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>

</geo_api>

Приклад JSON відповіді сервісу "Гео-IP 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",

}

Приклад XML відповіді сервісу "Провайдер-IP API":

<provider_api>

<name_ripe>PJSC "Datagroup"</name_ripe>

<name_rus>ЧАО "Датагруп"</name_rus>

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

<ip_range_start>83951616</ip_range_start>

<ip_range_end>83959807</ip_range_end>

</provider_api>

Приклад JSON відповіді сервісу "Провайдер-IP 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"

}

Приклад 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 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].