Геолокация по IP API
Страна, регион, город, координаты и часовой пояс для любого публичного адреса IPv4 или IPv6. На базе MaxMind GeoLite2 — полностью локальные вычисления, без общих лимитов запросов.
Нет API-ключа?
Войдите в аккаунт, чтобы создавать и управлять API-ключами.
Руководство по интеграции
Скопируйте сниппет, подставьте свой API-ключ, запустите. Работает в любом HTTP-клиенте — примеры ниже на cURL, JavaScript и Python.
/api/ip-geolocationhttps://www.apipick.comGet geolocation data for any public IP address
ipstringнеобязательныйPublic IPv4 or IPv6 address. Omit to look up caller's own IP. 8.8.8.8
curl -X GET "https://www.apipick.com/api/ip-geolocation" \
-H "x-api-key: YOUR_API_KEY"{
"success": true,
"code": 200,
"message": "ok",
"data": {
"ip": "8.8.8.8",
"country_code": "US",
"country_name": "United States",
"continent": "North America",
"continent_code": "NA",
"city": "Mountain View",
"latitude": 37.4056,
"longitude": -122.0775,
"timezone": "America/Los_Angeles",
"currency": "USD",
"isp": "Google LLC",
"asn": 15169
},
"credits_used": 1,
"remaining_credits": 99
}Создано для реальных сценариев
Выявление мошенничества
Помечайте регистрации или транзакции из регионов высокого риска. Проверяйте, совпадает ли IP пользователя с заявленным местоположением или страной оплаты.
Локализация контента
Автоматически выбирайте язык, валюту и региональные цены на основе местоположения посетителя. Показывайте баннеры cookie по нормам ЕС только посетителям из ЕС.
Ограничение запросов
Применяйте лимиты запросов или контроль доступа по странам. Блокируйте или ограничивайте трафик из определённых регионов без покупки дорогих инструментов безопасности.
Обогащение данных AI-агентами
Позвольте AI-агентам обогащать записи пользователей, классифицировать лиды по географии или локализовать сгенерированный контент на основе данных об IP в реальном времени.
Альтернатива ipinfo.io и ipapi.co
Оплата кредитами по аккаунту — без общего пула лимитов запросов, без тарифных уровней, без ежемесячных лимитов, которые сбрасываются в первый день месяца.
ipinfo.io | ipapi.co | API Pick ✓ | |
|---|---|---|---|
| Бесплатный тариф | 50k req/month | 1,000 req/day | 100 кредитов при регистрации |
| Модель ограничения запросов | Риск общего пула IP | Риск общего пула IP | Кредиты по аккаунту |
| Истекают ли кредиты / квота? | Ежемесячный сброс | Ежедневный сброс | Никогда не истекают |
| Страна + регион + город | ✓ | ✓ | ✓ |
| Часовой пояс | Платный тариф | ✓ | ✓ |
| Поддержка IPv6 | ✓ | ✓ | ✓ |
| Флаг членства в ЕС | Платный тариф | ✓ | ✓ |
| Старт без банковской карты | ✓ | ✓ | ✓ |
| Готовность к AI-агентам / LLM | Частично | Частично | ✓ Нативный JSON |
Проблема общего пула лимитов запросов
В бесплатных тарифах ipinfo.io и ipapi.co лимиты запросов применяются на IP клиента. Это значит, что все запросы из одного региона Vercel, AWS или GCP делят единый пул квот. Если другой арендатор на том же edge-узле уже исчерпал суточный лимит в 1000 запросов, ваши вызовы API начинают завершаться ошибкой — хотя вы ещё не сделали ни одного запроса.
Оплата кредитами: предсказуемо при любом масштабе
API Pick списывает по аккаунту, а не по IP. Каждый вызов списывает ровно 1 кредит с вашего баланса — только при успешном ответе. Кредиты никогда не истекают. Делаете вы 10 запросов или 10 000 в день — вы платите только за то, что используете, без риска неожиданных сбоев из-за общей квоты.
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
| data.ip | string | Запрошенный IP-адрес |
| data.country_code | string | Код страны ISO 3166-1 alpha-2 (например, US, DE, JP) |
| data.country_name | string | Полное название страны на английском |
| data.continent | string | Название континента (например, North America, Europe) |
| data.continent_code | string | Двухбуквенный код континента (например, NA, EU) |
| data.city | string | Название города (пустая строка, если недоступно) |
| data.latitude | number | null | Приблизительная широта местоположения IP |
| data.longitude | number | null | Приблизительная долгота местоположения IP |
| data.timezone | string | Идентификатор часового пояса IANA (например, America/Los_Angeles) |
| data.currency | string | Код валюты ISO 4217 для страны (например, USD, EUR) |
| data.isp | string | Название провайдера / организации из базы данных ASN |
| data.asn | integer | null | Номер автономной системы (например, 15169 для Google) |
| credits_used | integer | Кредитов списано за этот запрос |
| remaining_credits | integer | Кредитов осталось на вашем аккаунте |
Лимиты запросов
Ограничение действует на API-ключ, скользящее окно 60 секунд. При превышении вы получаете чистый 429 с заголовком Retry-After.
120req/min
На API-ключ, на эндпоинт. Скользящее окно 60 секунд.
3concurrent
Максимум одновременных активных запросов на API-ключ.
X-RateLimit-LimitМаксимум запросов в минутуX-RateLimit-RemainingОсталось запросов в текущем окнеX-RateLimit-ResetСекунд до сброса текущего окнаRetry-AfterСколько секунд ждать перед повтором (только при 429)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 120 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Часто задаваемые вопросы
В: Что произойдёт, если я не передам IP-адрес?
О: Эндпоинт автоматически определяет IP вызывающей стороны из заголовков запроса (X-Forwarded-For). Это удобно для серверных запросов, когда нужно определить местоположение конечного пользователя, не передавая IP явно.
В: Поддерживаются ли приватные IP?
О: Нет. Приватные IP (диапазоны RFC 1918, такие как 192.168.x.x, 10.x.x.x), loopback (127.0.0.1) и другие зарезервированные диапазоны возвращают ошибку 400. Поддерживаются только публично маршрутизируемые адреса IPv4 и IPv6.
В: Насколько точна геолокация?
О: На базе MaxMind GeoLite2-City. Точность на уровне страны обычно составляет 95–99%. Точность на уровне города зависит от региона — как правило, надёжная в Северной Америке и Европе, менее точная в отдельных частях Азии и Африки. Координаты обозначают общую область, а не точное физическое местоположение.
В: Могут ли AI-агенты использовать это как инструмент?
О: Да. Эндпоинт принимает единственный необязательный параметр запроса ip и возвращает плоский объект JSON — его легко предоставить как инструмент-функцию для OpenAI, Claude, LangChain или любого фреймворка агентов. Полезно для агентов, которым нужно учитывать местоположение пользователя, применять гео-правила или обогащать данные лидов региональным контекстом.
Используйте геолокацию по IP в Claude Code и AI-агентах
Установите официальный навык для Claude Code, чтобы определять геолокацию любого IP-адреса прямо внутри вашего AI-агента для кодинга — страна, город, провайдер, часовой пояс и многое другое на естественном языке.
Спрашивайте у своего AI-агента на естественном языке
Совместимые платформы
Навык Claude Code для API геолокации по IP APIpick
Возвращает страну, континент, город, широту/долготу, часовой пояс IANA, код валюты ISO, название провайдера и ASN для любого IP-адреса.