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

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


Наш 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 — перевіряема 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].