Вступление

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


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

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

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


Пример

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

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

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

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

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

Локализация

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

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

Лимиты

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

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