API определения IPv4

Страна, регион, город, приблизительные координаты, часовой пояс, сеть и её оператор, флаги дата-центра и прокси, а также блок угроз, который сообщает, поступали ли жалобы на адрес за злоупотребления или атаки и насколько серьёзные. Если не указать параметр ip, вы получите собственный адрес вызывающей стороны: это типичный случай для сайтов.

GEThttps://api.mygeocode.com/v1/ipv4?ip=...

Попробовать в демо Полный справочник

Пример

Запрос

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4?ip=8.8.8.8"

# The caller's own address
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4"

Геолокация IP-адреса с точностью до города является оценкой и всегда ею останется: адрес принадлежит сети, а не человеку. Страна определяется верно для значительно более чем 99 % адресов. Город надёжнее всего определяется для домашних интернет-провайдеров и хуже всего для мобильных операторов и дата-центров, поэтому они помечаются флагами.

Ответ

{
  "status": "ok",
  "ip": "1.0.164.165",
  "version": 4,
  "found": true,
  "prefix": "1.0.164.0/24",
  "country": "Thailand",
  "country_code": "TH",
  "continent": "Asia",
  "continent_code": "AS",
  "region": "Krung Thep Maha Nakhon",
  "region_code": null,
  "city": "Bangkok",
  "postcode": "10200",
  "lat": 13.749976,
  "lon": 100.516819,
  "timezone": "Asia/Bangkok",
  "utc_offset": "+07:00",
  "utc_offset_seconds": 25200,
  "is_eu": false,
  "asn": 23969,
  "as_name": "TOT Public Company Limited",
  "org": "TOT Public Company Limited",
  "usage_type": "Eyeball",
  "registry": "apnic",
  "allocated": "2008-10-22",
  "tags": ["dsl"],
  "is_anycast": false,
  "is_satellite": false,
  "is_datacenter": false,
  "is_proxy": false,
  "is_vpn_provider": false,
  "is_tor": false,
  "is_private": false,
  "abuse_email": "abuse@totisp.net",
  "threat": {
    "listed": true,
    "score": 90,
    "source_count": 2,
    "categories": ["abuse", "attacker"],
    "is_tor": false,
    "is_tor_exit": false,
    "is_bogon": false,
    "listings": [
      { "category": "abuse", "confidence": 100, "recency_days": 1 },
      { "category": "attacker", "confidence": null, "recency_days": null }
    ]
  },
  "updated_at": "2026-09-18 06:53:39"
}

Что вы получаете

Поле	Значение
`country`, `country_code`	Название страны и код ISO 3166-1 alpha-2.
`region`, `region_code`	Штат, провинция или аналогичная единица с кодом ISO 3166-2, если он существует.
`city`, `postcode`	Наиболее вероятные город и почтовый индекс. Отсутствуют, если неизвестны.
`lat`, `lon`	Координаты города или, если их нет, центра региона или страны.
`timezone`	Название IANA, по местоположению.
`asn`, `org`	Номер автономной системы и организация, которая анонсирует префикс.
`is_datacenter`	Адрес входит в диапазон хостинга или облака. Считайте город ненадёжным и учитывайте, что трафик может быть автоматическим.
`is_proxy`, `is_tor`, `is_vpn_provider`	Подтверждения для конкретного адреса о том, что он является ретранслятором Tor или внесён в списки прокси; и отдельно: продаёт ли оператор вообще услуги VPN.
`usage_type`, `tags`, `registry`, `allocated`, `abuse_email`	Какой тип оператора управляет сетью, его теги оператора, какой регистратор и когда выделил сеть, а также контакт для жалоб на злоупотребления.
`threat`	Блок репутации: внесён ли адрес в списки, оценка от 0 до 100, сколько независимых источников перечисляют адрес и в каких категориях, флаги Tor и bogon, а также каждая запись с её достоверностью и давностью. Обновляется ежедневно.

Где это используется

Локализация при первом визите

Выберите страну, валюту, язык и единицы измерения по умолчанию ещё до того, как посетитель что-либо ввёл. Передавайте адрес посетителя в ip со своего сервера.

Сигналы мошенничества и злоупотреблений

Сравнивайте страну IP со страной платёжного адреса. Рассматривайте is_proxy и is_datacenter как сигналы, а не как приговор.

Аналитика без cookie

Агрегируйте посещения по странам и регионам на стороне сервера по журналам доступа, вообще без отслеживания на стороне клиента.

Цена и лимиты

Один вызов равен одному запросу; каждый адрес в пакете считается отдельно. У каждого ключа есть 2 500 бесплатных запросов в день; сверх этого 0,0001 € за запрос с предоплаченного баланса или бесплатно на ключе Unlimited (50 € в месяц). Цены. Переходите с ip-api, ipinfo или ipstack? Эти форматы доступны как совместимые хосты. Для адресов IPv6 см. API определения IPv6.