📚 Документация API

Основная информация

Base URL: https://zus.su/api/v1

Формат ответа: JSON

Кодировка: UTF-8

GET /api/v1/lookup

Описание

Получить информацию об IP адресе: геолокацию, провайдера, тип (Tor/VPN/Bot/Datacenter)

Параметры запроса
Параметр Тип Обязательный Описание
ip string ✅ Да IP адрес для проверки (IPv4 или IPv6)
api_key string ✅ Да Ваш API ключ (получите в личном кабинете)
Пример запроса (IPv4)
curl "https://zus.su/api/v1/lookup?ip=8.8.8.8&api_key=YOUR_API_KEY"
Пример запроса (IPv6)
curl "https://zus.su/api/v1/lookup?ip=2001:4860:4860::8888&api_key=YOUR_API_KEY"
💡 Поддержка IPv6: API автоматически определяет тип IP адреса и использует соответствующую базу данных.
Пример успешного ответа (200 OK)
{
  "ip": "8.8.8.8",
  "country_code": "US",
  "country_name": "United States",
  "city": null,
  "city_approximate": false,
  "latitude": 37.751,
  "longitude": -97.822,
  "timezone": "America/Chicago",
  "isp": "GOOGLE",
  "organization": "GOOGLE",
  "asn": 15169,
  "detection": {
    "is_tor": false,
    "is_vpn": false,
    "vpn_provider": null,
    "is_datacenter": true,
    "datacenter_provider": "Google Cloud",
    "is_bot": true,
    "bot_name": "Googlebot",
    "bot_detected_by": "asn"
  },
  "credits": {
    "used": 1,
    "remaining": 99,
    "limit": 100,
    "reset_in_seconds": 3600
  }
}
Коды ошибок
Код Описание
400 Неверный формат IP адреса
401 Неверный или отсутствующий API ключ
429 Превышен лимит запросов
500 Внутренняя ошибка сервера
Пример ответа при превышении лимита (429)
{
  "error": "Rate limit exceeded",
  "message": "Превышен лимит запросов. Лимит обновится через 45мин 30сек.",
  "limit": 100,
  "reset_in_seconds": 2730,
  "reset_at": "2026-01-09T21:00:00.000000Z"
}

📋 Описание полей ответа

Поле Тип Описание
ip string IP адрес который был запрошен
country_code string|null Код страны (ISO 3166-1 alpha-2). См. справочник стран
country_name string|null Название страны на английском
city string|null Название города (если доступно)
city_approximate boolean Является ли город приблизительным (ближайший крупный город)
latitude float|null Широта (от -90 до 90)
longitude float|null Долгота (от -180 до 180)
timezone string|null Часовой пояс (IANA timezone, например: America/New_York)
isp string|null Интернет провайдер
organization string|null Организация владеющая IP
asn integer|null Номер автономной системы (ASN)
detection - Объект с результатами определения типа IP
detection.is_tor boolean Является ли IP выходным узлом Tor
detection.is_vpn boolean Является ли IP VPN сервером
detection.vpn_provider string|null Название VPN провайдера (если обнаружен)
detection.is_datacenter boolean Находится ли IP в дата-центре
detection.datacenter_provider string|null Название провайдера дата-центра (Google Cloud, AWS, Cloudflare и т.д.)
detection.is_bot boolean Является ли запрос от бота
detection.bot_name string|null Название бота (Googlebot, YandexBot, FacebookBot и т.д.)
detection.bot_detected_by string|null Метод определения бота (asn, user_agent, ip_range)
credits - Информация об использовании API
credits.used integer Количество использованных кредитов за этот запрос (обычно 1)
credits.remaining integer Оставшееся количество запросов в текущем часе
credits.limit integer Максимальное количество запросов в час (100 для FREE, 5000 для PREMIUM)
credits.reset_in_seconds integer Через сколько секунд обновится лимит (обычно 3600)

🌍 Справочник кодов стран (country_code)

Формат: ISO 3166-1 alpha-2 (двухбуквенные коды)
Использование: Используйте эти коды для фильтрации и правил по странам в вашем приложении

AD — Andorra
AE — United Arab Emirates
AF — Afghanistan
AG — Antigua and Barbuda
AI — Anguilla
AL — Albania
AM — Armenia
AO — Angola
AR — Argentina
AS — American Samoa
AT — Austria
AU — Australia
AW — Aruba
AZ — Azerbaijan
BA — Bosnia and Herzegovina
BB — Barbados
BD — Bangladesh
BE — Belgium
BF — Burkina Faso
BG — Bulgaria
BH — Bahrain
BI — Burundi
BJ — Benin
BM — Bermuda
BN — Brunei
BO — Bolivia
BR — Brazil
BS — Bahamas
BT — Bhutan
BW — Botswana
BY — Belarus
BZ — Belize
CA — Canada
CD — Congo (DRC)
CF — Central African Republic
CG — Congo
CH — Switzerland
CI — Cote dIvoire
CL — Chile
CM — Cameroon
CN — China
CO — Colombia
CR — Costa Rica
CU — Cuba
CV — Cape Verde
CW — Curacao
CY — Cyprus
CZ — Czechia
DE — Germany
DJ — Djibouti
DK — Denmark
DM — Dominica
DO — Dominican Republic
DZ — Algeria
EC — Ecuador
EE — Estonia
EG — Egypt
ER — Eritrea
ES — Spain
ET — Ethiopia
FI — Finland
FJ — Fiji
FK — Falkland Islands
FM — Micronesia
FO — Faroe Islands
FR — France
GA — Gabon
GB — United Kingdom
GD — Grenada
GE — Georgia
GF — French Guiana
GH — Ghana
GI — Gibraltar
GL — Greenland
GM — Gambia
GN — Guinea
GP — Guadeloupe
GQ — Equatorial Guinea
GR — Greece
GT — Guatemala
GU — Guam
GW — Guinea-Bissau
GY — Guyana
HK — Hong Kong
HN — Honduras
HR — Croatia
HT — Haiti
HU — Hungary
ID — Indonesia
IE — Ireland
IL — Israel
IM — Isle of Man
IN — India
IQ — Iraq
IR — Iran
IS — Iceland
IT — Italy
JE — Jersey
JM — Jamaica
JO — Jordan
JP — Japan
KE — Kenya
KG — Kyrgyzstan
KH — Cambodia
KI — Kiribati
KM — Comoros
KN — Saint Kitts and Nevis
KP — North Korea
KR — South Korea
KW — Kuwait
KY — Cayman Islands
KZ — Kazakhstan
LA — Laos
LB — Lebanon
LC — Saint Lucia
LI — Liechtenstein
LK — Sri Lanka
LR — Liberia
LS — Lesotho
LT — Lithuania
LU — Luxembourg
LV — Latvia
LY — Libya
MA — Morocco
MC — Monaco
MD — Moldova
ME — Montenegro
MG — Madagascar
MH — Marshall Islands
MK — North Macedonia
ML — Mali
MM — Myanmar
MN — Mongolia
MO — Macao
MP — Northern Mariana Islands
MQ — Martinique
MR — Mauritania
MS — Montserrat
MT — Malta
MU — Mauritius
MV — Maldives
MW — Malawi
MX — Mexico
MY — Malaysia
MZ — Mozambique
NA — Namibia
NC — New Caledonia
NE — Niger
NG — Nigeria
NI — Nicaragua
NL — Netherlands
NO — Norway
NP — Nepal
NR — Nauru
NU — Niue
NZ — New Zealand
OM — Oman
PA — Panama
PE — Peru
PF — French Polynesia
PG — Papua New Guinea
PH — Philippines
PK — Pakistan
PL — Poland
PR — Puerto Rico
PS — Palestine
PT — Portugal
PW — Palau
PY — Paraguay
QA — Qatar
RE — Reunion
RO — Romania
RS — Serbia
RU — Russia
RW — Rwanda
SA — Saudi Arabia
SB — Solomon Islands
SC — Seychelles
SD — Sudan
SE — Sweden
SG — Singapore
SH — Saint Helena
SI — Slovenia
SK — Slovakia
SL — Sierra Leone
SM — San Marino
SN — Senegal
SO — Somalia
SR — Suriname
SS — South Sudan
ST — Sao Tome and Principe
SV — El Salvador
SX — Sint Maarten
SY — Syria
SZ — Eswatini
TC — Turks and Caicos Islands
TD — Chad
TG — Togo
TH — Thailand
TJ — Tajikistan
TK — Tokelau
TL — Timor-Leste
TM — Turkmenistan
TN — Tunisia
TO — Tonga
TR — Turkey
TT — Trinidad and Tobago
TV — Tuvalu
TW — Taiwan
TZ — Tanzania
UA — Ukraine
UG — Uganda
US — United States
UY — Uruguay
UZ — Uzbekistan
VA — Vatican City
VC — Saint Vincent and the Grenadines
VE — Venezuela
VG — British Virgin Islands
VI — U.S. Virgin Islands
VN — Vietnam
VU — Vanuatu
WS — Samoa
YE — Yemen
YT — Mayotte
ZA — South Africa
ZM — Zambia
ZW — Zimbabwe

⚡ Лимиты запросов

Тариф Лимит Цена
Бесплатный 100 запросов/час $0
Платный 5000 запросов/час $10

Зарегистрироваться →

💬 Нужна помощь?

Если у вас возникли вопросы или нужна помощь с интеграцией API, свяжитесь с нами: @ntsova