Вступление

Используйте наш API для быстрой и простой интеграции определения местоположения посетителя по IP адресу, в ваш скрипт или веб-сайт. Избавьте себя от необходимости настраивать локальные библиотеки GeoIP и забудьте о регулярном обновлении данных. Наша нейросеть анализирует десятки источников и обновляет базу данных практически в режиме реального времени.


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

Вы можете вызвать API, отправив GET запрос http://ipwhois.app/xml/{IP}

{IP} может быть IPv4 или IPv6 адресом, оставьте параметр пустым чтобы использовать текущий IP-адрес.


Пример

Вы можете отредактировать этот запрос и поэкспериментировать с параметрами

GET
Ответ
<?xml version="1.0" encoding="UTF-8"?>
<query>
	<ip>8.8.4.4</ip>
	<success>1</success>
	<type>IPv4</type>
	<continent>North America</continent>
	<continent_code>NA</continent_code>
	<country>United States</country>
	<country_code>US</country_code>
	<country_flag>https://cdn.ipwhois.io/flags/us.svg</country_flag>
	<country_capital>Washington</country_capital>
	<country_phone>+1</country_phone>
	<country_neighbours>CA,MX,CU</country_neighbours>
	<region>New Jersey</region>
	<city>Newark</city>
	<latitude>40.735657</latitude>
	<longitude>-74.1723667</longitude>
	<asn>AS15169</asn>
	<org>Google LLC</org>
	<isp>Google LLC</isp>
	<timezone>America/New_York</timezone>
	<timezone_name>Eastern Standard Time</timezone_name>
	<timezone_dstOffset>0</timezone_dstOffset>
	<timezone_gmtOffset>-18000</timezone_gmtOffset>
	<timezone_gmt>GMT -5:00</timezone_gmt>
	<currency>US Dollar</currency>
	<currency_code>USD</currency_code>
	<currency_symbol>$</currency_symbol>
	<currency_rates>1</currency_rates>
	<currency_plural>0</currency_plural>
</query>

Возвращенные данные

API может возвращать следующие поля и значения

название описание
ip Запрашиваемый IP адрес (пример 8.8.4.4)
success true или false
message Включается только тогда, когда success является false
Может быть одним из следующих: invalid IP address, you've hit the monthly limit
type Тип IP адреса (IPv4 или IPv6)
continent Название континента (пример North America)
continent_code Двухбуквенный код континента (пример NA)
country Название страны (пример United States)
country_code Двухбуквенный код страны (пример US)
country_capital Столица страны (пример Washington)
country_phone Телефонный код страны (пример +1)
country_neighbours Соседние страны (пример CA,MX,CU)
region Регион/штат (пример Virginia)
city Город (пример Ashburn)
latitude Широта (пример 39.0437567)
longitude Долгота (пример -77.4874416)
as Номер AS (пример AS15169)
org Название организации (пример Level 3 Communications)
isp Имя провайдера (пример Level 3 Communications)
timezone Часовой пояс (пример America/New_York)
timezone_name Полное название часового пояса (пример Eastern Standard Time)
timezone_dstOffset Смещение для летнего времени в секундах.
timezone_gmtOffset Смещение от UTC (в секундах) для данного местоположения. (пример -18000)
timezone_gmt Часовой пояс GMT. (пример GMT -5:00)
currency Название валюты страны. (пример US Dollar)
currency_code Код валюты страны. (пример USD)
currency_symbol Символ валюты страны. (пример $)
currency_rates Текущий курс по отношению к доллару США.
currency_plural Название валюты во множественном числе. (пример US dollars)
completed_requests Количество обращений к API за текущий месяц (Обновляется раз в 2 минуты).

Укажите поля ответа

Если вам не требуются все возвращаемые поля, вы можете ограничить набор результатов API определенными полями, для этого добавьте параметр GET objects к URL-адресу запроса к API и установите для него определенное поле или список полей через запятую.

Например: objects=country,city,timezone


Локализация

Локализацию city, region, country и continent можно запросить, установив для GET параметра lang одно из следующих значений:

язык описание демо
en English (default)
ru Русский (Russian)
de Deutsch (German)
es Español (Spanish)
pt-BR Español - Argentina (Spanish)
fr Français (French)
zh-CN 中国 (Chinese)
ja 日本語 (Japanese)

Лимиты

Вы можете пользоваться нашим API бесплатно до 10,000 запросов в месяц.

Мы против коммерческого использования бесплатного плана. Пожалуйста, ознакомьтесь с нашим профессиональным сервисом для доступа к SSL, расширенным возможностям и коммерческой поддержки.