Перейти к содержимому
POST AI agent ready /v1/ip/lookup

API геолокации IP — бесплатный поиск IP-адреса

Возвращает данные геолокации для IP-адреса, включая страну, город, регион, координаты, часовой пояс, ASN и центр обработки данных Cloudflare. Если IP-адрес не указан, используется собственный IP-адрес вызывающего абонента.

Parameters

string

IPv4 or IPv6 address to geolocate. Omit to look up the caller's own IP.

Code examples

curl -X POST https://api.botoi.com/v1/ip/lookup \
  -H "Content-Type: application/json" \
  -d '{"ip":"203.0.113.1"}'

When to use this API

Персонализация контента в зависимости от местоположения посетителя

Определите страну и город посетителя при загрузке страницы, чтобы показать локализованные цены, язык или варианты доставки. Страница оформления заказа SaaS может вызывать эту конечную точку для предварительного заполнения поля выбора валюты на основе кода страны посетителя.

Оценка мошенничества в платежных конвейерах

Сравните геолокацию IP-адреса транзакции с платежным адресом в файле. Отмечайте заказы, в которых IP-адрес соответствует стране, отличной от страны-эмитента карты, и направляйте помеченные транзакции через проверку вручную.

Ведение журнала соответствия для аудита доступа

Записывайте страну и регион каждого входа администратора на внутреннюю панель управления. Создавайте ежемесячный отчет о событиях доступа, сгруппированных по географическому признаку, чтобы удовлетворить требования аудита SOC 2 или GDPR.

Frequently asked questions

Насколько точны данные геолокации IP?
Точность на уровне страны превышает 99%. Точность на уровне города варьируется в зависимости от региона, но обычно составляет 80-90% для основных интернет-провайдеров. IP-адреса и VPN оператора мобильной связи могут определять штаб-квартиру оператора, а не физическое местоположение пользователя.
Поддерживает ли эта конечная точка адреса IPv6?
Да. Передайте любой действительный адрес IPv6 в поле ip. Ответ включает в себя те же поля геолокации, что и запросы IPv4.
Что произойдет, если я опущу параметр ip?
Конечная точка возвращает данные геолокации для собственного IP-адреса вызывающего абонента. Это полезно для определения местоположения посетителя веб-сайта без использования клиентского JavaScript.
Что такое поле ASN?
ASN означает номер автономной системы. Он идентифицирует оператора сети (например, Comcast, AWS или Cloudflare), которому принадлежит блок IP-адресов. Поле as_organization дает удобочитаемое имя.
Есть ли ограничение скорости на этой конечной точке?
Анонимные запросы ограничены до 5 в минуту в зависимости от вашего IP. Аутентифицированные запросы с ключом API имеют более высокие ограничения в зависимости от вашего плана.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs