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

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

Возвращает данные геолокации для нескольких IP-адресов в одном запросе. Включает собственную информацию об IP-адресе вызывающего абонента вместе с результатами для каждого запрошенного IP-адреса.

Parameters

arrayrequired

Array of IPv4 or IPv6 addresses to geolocate.

Code examples

curl -X POST https://api.botoi.com/v1/ip/bulk \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}'

When to use this API

Пакетное расширение журналов событий аналитики

После сбора событий аналитики за день извлеките уникальные IP-адреса посетителей и отправьте их через массовую конечную точку. Добавьте данные о стране и городе в каждую строку события перед загрузкой в ​​хранилище данных для географической отчетности.

Карта распределенной инфраструктуры

Передайте список IP-адресов вашего сервера, узла CDN и балансировщика нагрузки в эту конечную точку. Нанесите полученные координаты на карту, чтобы визуализировать зону покрытия вашей инфраструктуры и выявить географические пробелы в покрытии.

Frequently asked questions

Сколько IP-адресов я могу отправить в одном запросе?
Вы можете отправить до 100 IP-адресов за один запрос. Для больших наборов данных разделите их на пакеты и отправьте несколько запросов.
Включает ли ответ мой собственный IP-адрес?
Да. Ответ включает поле caller_ip с геолокацией вашего собственного IP, а также результаты для каждого IP в массиве ips.
Обрабатываются ли повторяющиеся IP-адреса в массиве?
Дубликаты IP-адресов разрешаются независимо. Каждая запись в массиве ips получает свой собственный объект результата, даже если один и тот же IP-адрес появляется несколько раз.
Что произойдет, если один IP-адрес в пакете недействителен?
Конечная точка возвращает результаты для всех допустимых IP-адресов и включает сообщение об ошибке для любого IP-адреса, который не удалось разрешить. Запрос не завершается полным сбоем из-за одной неверной записи.

Get your API key

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