API URL

GET → https://api.ip-api.ru/TYPE/IP_ADDRESS?api_key=API_KEY

GET	Тип	Описание	Обязательно
`TYPE`	string	Формат получения данных: `json`, `xml`, `yaml` или `csv`.	Да
`IP_ADDRESS`	string	Требуемый для проверки IP-адрес: `IPv4` или `IPv6`. Если не задан - проверяется IP-адрес с которого сделан запрос.	Нет
`API_KEY`	string	API KEY для работы с `api.ip-api.ru`.	Да

Пример правильного URL: https://api.ip-api.ru/json/1.1.1.1?api_key=API_KEY

Структура

Ключ	Тип	Описание
`status`	string	Статус запроса: `success` или `fail`.
`api`	object	Служебная информация по Вашей учетной записи `api.ip-api.ru`.
`IP_ADDRESS`	object	Полная информация по IP-адресу.

API →

Ключ	Тип	Описание
`version`	string	Версия API.
`apiRequests →`	object	Вывод количества запрсов и лимитов по `api.ip-api.ru`.
`→ time_zone`	string	Временная зона учета лимитов. Можно выставить любую в настройках учетной записи.
`→ today`	integer	Количество запросов к `api.ip-api.ru` за текущий день.
`→ daily_plan`	integer	Максимально доступное количество запросов в сутки по тарифному плану.

IP_ADDRESS →

Ключ	Тип	Описание
`asn`	string	ASN (Autonomous System Number).
`range`	string	IP диапазон (CIDR).
`provider`	string	Провайдер / владелец IP-адреса.
`org`	string	Организация или точка присутствия (POP).
`host_name`	string	Reverse DNS / hostname (если доступен).
`connection →`	object	Объект с максимально полной информацией по IP-адресу
`→ user_agent`	string	Актуальный User-Agent клиента при подключении к `api.ip-api.ru`.
`→ user_language`	string	Предпочитаемые языки клиента.
`→ type`	string	Тип сети: `Business`, `Residential`, `Wireless`, `Hosting` или `Unknown`.
`→ is_anonymity`	boolean	Общий флаг анонимности.
`→ redFlags →`	object	Выявленные красные флаги анонимности.
`→ proxy`	boolean	IP-адрес используется в сервисах предоставления публичных или приватных Proxy.
`→ vpn`	boolean	IP-адрес используется в сервисах предоставления публичных или приватных VPN.
`→ tor`	boolean	IP-адрес используется в сети TOR.
`→ hosting`	boolean	IP-адрес используется дата-центром или хостинг-провайдером.
`→ anonymous`	boolean	IP-адрес использовался как Proxy или VPN.
`→ compromised`	boolean	IP-адрес был перехвачен или скомпромитирован.
`→ scraper`	boolean	IP-адрес используется в сервисах веб-парсинга.
`→ operator →`	object	Информация об операторе-поставщике услуг.
`→ name`	string	Название оператора-поставщика.
`→ url`	string	Официальный сайт.
`→ anonymity`	string	Уровень заявленной анонимности.
`→ popularity`	string	Популярность сервиса.
`→ services`	array	Типы услуг: `datacenter_vpns` `residential_proxies` и другие.
`→ protocols`	array	Поддерживаемые протоколы: `WireGuard`, `OpenVPN`, `IPSec`, `IKEv2` и другие.
`→ policies →`	object	Информация о внутренней и публичной политике предоставлении услуг операторором-поставщиком услуг.
`→ logging`	boolean	Логирование действий клиентов в сети.
`→ anonymous_payments`	boolean	Прием оплаты за услуги без регистрации или с возможностью вводом данных банковской карты третьего лица.
`→ crypto_payments`	boolean	Прием оплаты за услуги в криптовалюте.
`→ ad_filtering`	boolean	Фильтрация рекламы и подмена рекламы для клиента.
`→ port_forwarding`	boolean	Поддержка услуги "проброс портов" (снижает уровень анонимности клиента).
`→ trustAssessment →`	object	Объект с информацией об оценке доверия к IP-адресу.
`→ value`	integer	Оценка доверия к IP-адресу: от `0` до `100`.
`→ confidence`	integer	Достоверность оценки доверия на основе внутренних алгоритмов `api.ip-api.ru`: от `0` до `100`
`→ deviceEstimate →`	object	Информация о примерном количестве пользователей, использующих IP-адрес.
`→ address`	integer	Примерное количество пользователей, которые могут использовать IP-адрес.
`→ subnet`	integer	Примерное количество пользователей, которые могут использовать другие IP-адреса из этой подсети.
`→ history →`	object	Актуальность информации IP-адреса в `api.ip-api.ru`.
`→ last_updated`	integer	Последняя дата обновления всей информации по IP-адресу.
`→ location →`	object	Общая краткая информация о стране, в которой зарегистрирован IP-адрес.
`→ country`	string	Страна.
`→ region`	string	Регион.
`→ city`	string	Город.
`→ lat`	string	Широта.
`→ lon`	string	Долгота.
`→ timezone`	string	Часовой пояс.
`→ currency →`	object	Информация о валюте.
`→ code`	string	Код валюты.
`→ name`	string	Название валюты.
`→ symbol`	string	Символ валюты.
`→ assets →`	object	Дополнительные материалы по стране.

Пример ответа в формате json

{
  "status": "success",
  "api": {
    "version": "v2",
    "apiRequests": {
      "time_zone": "Europe/Moscow",
      "today": 4,
      "daily_plan": 25000
    }
  },
  "185.59.221.75": {
    "asn": "AS60068",
    "range": "185.59.221.0/24",
    "host_name": "Unknown",
    "provider": "Datacamp Limited",
    "org": "CDN77 - London POP",
    "connection": {
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:143.0) Gecko/20100101 Firefox/143.0",
      "user_language": "ru-RU,ru;q=0.8,en-US;q=0.5,en;q=0.3",
      "is_anonymity": true,
      "type": "Hosting",
      "redFlags": {
        "proxy": true,
        "vpn": true,
        "compromised": true,
        "scraper": false,
        "tor": false,
        "hosting": true,
        "anonymous": true
      },
      "operator": {
        "name": "IVPN",
        "url": "https://www.ivpn.net/",
        "anonymity": "high",
        "popularity": "medium",
        "services": [
          "datacenter_vpns"
        ],
        "protocols": [
          "WireGuard",
          "OpenVPN",
          "IPSec",
          "IKEv2"
        ],
        "policies": {
          "ad_filtering": true,
          "free_access": false,
          "paid_access": true,
          "port_forwarding": false,
          "logging": false,
          "anonymous_payments": true,
          "crypto_payments": true,
          "traceable_ownership": true
        },
        "trustAssessment": {
          "value": 100,
          "confidence": 100,
        },
        "deviceEstimate": {
          "address": 10,
          "subnet": 1150
        },
        "history": {
          "last_updated": "2026-04-15T00:07:51Z"
        }
      }
    },
    "location": {
      "continent": "Europe",
      "continentCode": "EU",
      "country": "United Kingdom",
      "iso_code": "GB",
      "region": "England",
      "region_code": "ENG",
      "timezone": "Europe/London",
      "city": "London",
      "post_code": "W1B",
      "lat": "51.5072",
      "lon": "-0.1276",
      "currency": {
        "code": "GBP",
        "name": "Pound",
        "symbol": "£"
      },
      "assets": {
        "flags": {
          "waving": [
            "https://api.ip-api.ru/assets/flags/16x12/gb.png",
            "https://api.ip-api.ru/assets/flags/20x15/gb.png",
            "https://api.ip-api.ru/assets/flags/24x18/gb.png",
            "https://api.ip-api.ru/assets/flags/28x21/gb.png",
            "https://api.ip-api.ru/assets/flags/32x24/gb.png",
            "https://api.ip-api.ru/assets/flags/36x27/gb.png",
            "https://api.ip-api.ru/assets/flags/40x30/gb.png",
            "https://api.ip-api.ru/assets/flags/48x36/gb.png",
            "https://api.ip-api.ru/assets/flags/56x42/gb.png",
            "https://api.ip-api.ru/assets/flags/60x45/gb.png",
            "https://api.ip-api.ru/assets/flags/64x48/gb.png",
            "https://api.ip-api.ru/assets/flags/72x54/gb.png",
            "https://api.ip-api.ru/assets/flags/80x60/gb.png",
            "https://api.ip-api.ru/assets/flags/84x63/gb.png",
            "https://api.ip-api.ru/assets/flags/96x72/gb.png",
            "https://api.ip-api.ru/assets/flags/108x81/gb.png",
            "https://api.ip-api.ru/assets/flags/112x84/gb.png",
            "https://api.ip-api.ru/assets/flags/120x90/gb.png",
            "https://api.ip-api.ru/assets/flags/128x96/gb.png",
            "https://api.ip-api.ru/assets/flags/144x108/gb.png",
            "https://api.ip-api.ru/assets/flags/160x120/gb.png",
            "https://api.ip-api.ru/assets/flags/192x144/gb.png",
            "https://api.ip-api.ru/assets/flags/224x168/gb.png",
            "https://api.ip-api.ru/assets/flags/256x192/gb.png"
          ],
          "original": {
            "sameWidth": [
              "https://api.ip-api.ru/assets/flags/w20/gb.png",
              "https://api.ip-api.ru/assets/flags/w40/gb.png",
              "https://api.ip-api.ru/assets/flags/w80/gb.png",
              "https://api.ip-api.ru/assets/flags/w160/gb.png",
              "https://api.ip-api.ru/assets/flags/w320/gb.png",
              "https://api.ip-api.ru/assets/flags/w640/gb.png",
              "https://api.ip-api.ru/assets/flags/w1280/gb.png",
              "https://api.ip-api.ru/assets/flags/w2560/gb.png"
            ],
            "sameHeight": [
              "https://api.ip-api.ru/assets/flags/h20/gb.png",
              "https://api.ip-api.ru/assets/flags/h24/gb.png",
              "https://api.ip-api.ru/assets/flags/h40/gb.png",
              "https://api.ip-api.ru/assets/flags/h60/gb.png",
              "https://api.ip-api.ru/assets/flags/h80/gb.png",
              "https://api.ip-api.ru/assets/flags/h120/gb.png",
              "https://api.ip-api.ru/assets/flags/h240/gb.png"
            ]
          }
        }
      }
    }
  }
}

Полная документация по работе с IP-API

API URL

Структура

Пример ответа в формате json