IP Геолокация

Определение географического положения, провайдера и ASN по IP-адресу. Поддержка IPv4 и IPv6, batch-запросы до 100 адресов.

Эндпоинты

Метод	Эндпоинт	Описание
`GET`	`/v1/ipinfo`	Геолокация по IP клиента (автоопределение)
`GET`	`/v1/ipinfo/{ip}`	Геолокация по указанному IP
`POST`	`/v1/ipinfo/batch`	Геолокация для нескольких IP (до 100)

Запрос по одному IP

curl https://proxy.unoapi.ru/v1/ipinfo/8.8.8.8 \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch('https://proxy.unoapi.ru/v1/ipinfo/8.8.8.8', {
  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
});

const data = await response.json();
console.log(data);
// { ip: '8.8.8.8', country: 'US', city: 'Mountain View', ... }

import requests

response = requests.get(
    'https://proxy.unoapi.ru/v1/ipinfo/8.8.8.8',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

data = response.json()
print(data)

req, _ := http.NewRequest("GET", "https://proxy.unoapi.ru/v1/ipinfo/8.8.8.8", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

client := &http.Client{}
resp, _ := client.Do(req)
// ...

Пример ответа

{
  "ip": "8.8.8.8",
  "country": "US",
  "country_name": "United States",
  "city": "Mountain View",
  "region": "California",
  "region_code": "CA",
  "postal": "94035",
  "latitude": 37.386,
  "longitude": -122.0838,
  "timezone": "America/Los_Angeles",
  "asn": 15169,
  "org": "GOOGLE"
}

Определение IP клиента

Запрос без параметров возвращает геолокацию по IP-адресу клиента. Полезно для определения местоположения пользователя.

curl https://proxy.unoapi.ru/v1/ipinfo \
  -H "Authorization: Bearer YOUR_API_KEY"

Пакетные запросы

Получение геолокации для нескольких IP-адресов за один запрос. Максимум 100 адресов.

cURL
TypeScript

curl -X POST https://proxy.unoapi.ru/v1/ipinfo/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips": ["8.8.8.8", "77.88.8.8", "1.1.1.1"]}'

const response = await fetch('https://proxy.unoapi.ru/v1/ipinfo/batch', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    ips: ['8.8.8.8', '77.88.8.8', '1.1.1.1']
  })
});

const data = await response.json();
console.log(data.results['8.8.8.8'].country);  // 'US'
console.log(data.results['77.88.8.8'].country); // 'RU'

Пример ответа

{
  "results": {
    "8.8.8.8": {
      "ip": "8.8.8.8",
      "country": "US",
      "city": "Mountain View",
      "asn": 15169,
      "org": "GOOGLE"
    },
    "77.88.8.8": {
      "ip": "77.88.8.8",
      "country": "RU",
      "city": "Moscow",
      "asn": 13238,
      "org": "YANDEX"
    }
  }
}

Поля ответа

Ответ содержит следующие поля (все кроме ip опциональны):

ip — запрошенный IP-адрес
country / country_name — код и название страны
city, region, postal — город, регион, индекс
latitude, longitude — координаты
timezone — часовой пояс (IANA)
asn, org — номер AS и название провайдера