Страна, регион и город
Приблизительная география IP-адреса по справочнику. Доступность и детализация полей зависят от конкретной сети.
REST API для разработчиков
GeoIP API: геолокация, провайдер и местное время по IP-адресу
Получайте географию сети, ASN, провайдера и часовой пояс по IPv4 или IPv6. Встраивайте ответ JSON в сайт, CRM или серверную обработку заявок.
100 запросов бесплатно в календарный месяц.
Что можно определить по IP через API
ASN и провайдер
Номер автономной системы и сведения о сетевом операторе помогают дополнить технический контекст заявки.
Часовой пояс и время
Локальное время для найденной географии можно использовать при планировании уведомлений и общения с клиентом.
IPv4 и IPv6
Один endpoint принимает оба формата IP. Передавайте чистый адрес без порта и URL; внутренний адрес не даёт публичную географию сети.
GeoIP показывает приблизительное положение сети. VPN, прокси, мобильные сети и маршрутизация могут менять результат. API не определяет точный домашний адрес, личность или фактическое местоположение человека.
Попробуйте GeoIP API онлайн
Реальный ответ сервиса без API-ключа. Для интеграции создайте свой ключ в кабинете.
Ответ APIJSON
Ответ появится здесь
Как использовать GeoIP на сайте и в CRM
Предлагайте регион по IP как предварительный вариант и сохраняйте возможность исправить его. Для заявки можно добавить страну, часовой пояс и сетевой контекст, не заставляя посетителя вводить всё вручную.
- Получите IP клиента на своём сервере с учётом доверенных прокси.
- Передайте ip в POST /geoip/v1/lookup с ключом scope geoip.
- Используйте доступные поля JSON и разрешите пользователю уточнить предложенный регион.
Пример запроса к GeoIP API
curl -X POST 'https://api.ibop.ru/geoip/v1/lookup' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"ip":"8.8.8.8"}'Получите ключ после входа через MAX и передавайте его в Authorization: Bearer YOUR_API_KEY. Область доступа ключа должна включать geoip. Храните секрет на сервере своей интеграции.
Основные поля ответа JSON
Полный ответ можно увидеть в демо. Отсутствующие справочные данные могут иметь значение null; учитывайте это в интеграции.
| Поле | Значение |
|---|---|
data.ip, data.ip_version | Нормализованный адрес и версия IP. |
data.found, data.scope, data.reason | Признак найденных сведений, область адреса и причина отсутствия данных. Внутренние адреса возвращают non_public_ip. |
data.country, data.location | Страна, регион, город и приблизительные координаты; accuracy_radius_km описывает радиус точности, если он известен. |
data.asn, data.provider | Автономная система и провайдер. Поля могут быть null, даже когда география найдена. |
data.timezone | Имя часового пояса, местное время, смещение UTC и основание определения. |
Авторизация, ошибки и учёт запросов
Некорректные входные данные возвращают HTTP 422. Ошибки доступа требуют проверки ключа и его областей. При исчерпании квоты API отвечает HTTP 429 с кодом quota_exceeded; ограничения частоты запросов действуют отдельно. Ошибка провайдера возвращает зарезервированную единицу квоты.
Тарифы GeoIP API
Цены и квоты загружаются из действующего каталога API.
Бесплатно
0 ₽/ месяц
100запросов
Получить API-ключСтарт
299 ₽/ месяц
10 000запросов
Выбрать тарифПро
990 ₽/ месяц
100 000запросов
Выбрать тарифREST API и авторизованный MCP используют общие квоты аккаунта по каждому продукту. Бесплатный месяц считается по московскому времени. Платный период начинается после подтверждения оплаты. Заказ сам по себе не активирует пакет; оплата подтверждается вручную, автоматических списаний нет.
Вопросы о GeoIP API
Поддерживаются ли IPv6-адреса?
Да. Поле ip принимает корректный IPv4 или IPv6 без порта. Возвращаемая детализация зависит от доступных данных для конкретного адреса.
Насколько точен город по IP?
Город является справочным приближением. IP может относиться к узлу провайдера, VPN или мобильной сети в другой локации. Не используйте такой результат как подтверждённый адрес клиента.
Откуда берутся географические данные?
Сведения об источниках GeoIP и лицензиях опубликованы на странице «Источники данных». Для интеграции используйте публичный API ibop; частные справочники не нужно загружать в своё приложение.