DNS и инфраструктура 1 Конечные точки 8 Ключевые возможности

API для Геолокация IP

Запрашивайте предоставленные провайдером примерные данные о геолокации и сети для IP-адреса. DomScan добавляет флаг прокси от провайдера, курируемый список выходных узлов Tor, грубые признаки VPN по ASN и ориентированное на IPv4 обогащение PTR, FCrDNS и диапазонами облаков.

Category DNS и инфраструктура
Конечные точки 1
Ключевые возможности 8
Заголовок 4

Используется сотрудниками известных компаний

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

Сигналы доверия перед интеграцией

Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить DomScan перед запуском.

Работает Статус сервиса

Перед интеграцией проверьте состояние сервиса в реальном времени и документированные ответы при сбоях.

OpenAPI API-артефакты

OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.

API-ключи Защищенный доступ

Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.

10,000 Бесплатный лимит

Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.

Что помогает запустить эта API

Используйте эту страницу как производственный бриф: конечные точки, примеры, форма ответа и элементы workflow для подключения DomScan к вашему продукту.

Продуктовые workflow

Встраивайте проверки доменов, DNS-интеллект, сигналы риска или обогащение в онбординг, поиск и внутренние инструменты.

Автоматизация аналитиков

Заменяйте повторяющиеся ручные проверки расписаниями, оповещениями и воспроизводимыми шагами расследования.

Чистые JSON-данные

Используйте предсказуемые поля, документированные коды состояния и стоимость в кредитах вместо scraping страниц провайдеров.

AI и ops-инструменты

Передавайте данные агентам, дашбордам, SOAR-плейбукам и CRM через OpenAPI, SDK, Postman или MCP.

Интеграционный workflow

Простой путь от первого запроса до повторяемого использования в продакшене.

1
Аутентифицируйтесь один раз

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

2
Запрашивайте по примерам

Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.

3
Эксплуатируйте и мониторьте

Используйте коды состояния, стоимость кредитов и поля ответа для retries, логов и alerts.

Набор разработчика

Переходите к машиночитаемой документации, коллекциям запросов, SDK или инструментам для агентов.

Карта параметров и ответа

Просмотрите входы, поля ответа и коды состояния перед подключением endpoint к клиенту.

Параметры запроса

Параметр

ip
Поля ответа

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

ipdomaingeolocationgeolocation.countrygeolocation.country_namegeolocation.regiongeolocation.region_namegeolocation.citygeolocation.postalgeolocation.latitudegeolocation.longitudegeolocation.timezone
Покрытие статусов

Коды статуса HTTP

200400401402429504

Конечные точки

GET /v1/ip
Кредиты: 1Аутентификация: Требуется аутентификация
ip

Сигналы доверия перед интеграцией

Прозрачная документация, аутентифицированные запросы и видимые сведения о надежности помогают оценить DomScan перед запуском.

Статус сервиса API-артефакты

OpenAPI, Swagger, Postman, CLI, SDK и ссылки MCP доступны в один клик.

API-ключи Защищенный доступ

Аутентифицированные эндпоинты используют API-ключи с понятной стоимостью в кредитах до вызова.

Бесплатный лимит Зарегистрируйтесь Бесплатно

Начните с 10 000 кредитов в месяц и обновляйтесь только при росте использования.

Активен Пример запроса

Начните с примеров curl и HTTP, затем перенесите параметры в код приложения.

Ключевые возможности

Примерная геолокация

Предоставленные провайдером город, регион, страна, почтовый индекс и координаты являются приблизительными, а не точным местоположением.

Определение ISP

Просмотрите интернет-провайдера, указанного поставщиком данных.

Поиск организации

Просмотрите организацию, которую провайдер данных связывает с IP-адресом.

Информация об ASN

Получите номер автономной системы для сетевого контекста.

Признаки хостинга и облака

Для IPv4 адрес сравнивается с известными диапазонами облачных провайдеров; также могут быть доступны базовые поля хостинга от поставщика данных.

Сигналы прокси, VPN и Tor

Используются флаг прокси от провайдера, курируемый список выходных узлов Tor и грубые признаки VPN по ASN, а не поведенческий анализ.

Поиск часового пояса

Просмотрите часовой пояс для примерного местоположения от провайдера.

Обратный DNS и FCrDNS для IPv4

Для IPv4 выполняется запрос PTR и проверка forward-confirmed reverse DNS. Домен, переданный вызывающей стороной, никогда не определяет классификацию PTR.

Пример запроса

GET /v1/ip bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8"

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

200 OK json
{
  "ip": "8.8.8.8",
  "domain": null,
  "geolocation": {
    "country": "US",
    "country_name": "United States",
    "region": null,
    "region_name": null,
    "city": null,
    "postal": null,
    "latitude": null,
    "longitude": null,
    "timezone": null,
    "precision": "country"
  },
  "network": {
    "asn": 15169,
    "asn_name": "AS15169",
    "asn_org": "Google LLC",
    "isp": "Google LLC",
    "connection_type": "hosting"
  },
  "security": {
    "is_proxy": false,
    "is_vpn": false,
    "is_tor": false,
    "is_tor_exit": false,
    "is_datacenter": true,
    "is_cloud": true,
    "cloud_provider": "Google Cloud",
    "threat_score": 0,
    "type_classification": {
      "type": "datacenter",
      "confidence": "high"
    },
    "fcrdns": {
      "ptr": "dns.google",
      "fcrdns_valid": true
    }
  },
  "intelligence_summary": {
    "query_type": "ip",
    "domain_resolved": false,
    "cache_status": "miss",
    "data_source": "cloudflare-intel+enrichment",
    "confidence": "high",
    "confidence_score": 100,
    "asn_present": true,
    "organization_present": true,
    "country_present": true,
    "security_signal_count": 2,
    "risk_flags": [
      "cloud",
      "datacenter"
    ],
    "hosting_category": "cloud"
  },
  "meta": {
    "query_time_ms": 118,
    "cached": false,
    "source": "cloudflare-intel+enrichment"
  }
}

Заголовок

Насколько точна геолокация?

Геолокация поступает от поставщика данных и является приблизительной. Используйте ее для общего контекста страны, региона или города, но не для точного определения местоположения устройства или человека.

Можно ли искать IPv6-адреса?

Базовые данные IPv6 от провайдера могут быть доступны, но обогащение PTR, FCrDNS и диапазонами облаков сейчас ориентировано на IPv4. Не ожидайте одинакового обогащения для IPv6.

Как определяются сигналы прокси, VPN и Tor?

DomScan объединяет флаг прокси от провайдера, курируемый список выходных узлов Tor и грубые признаки от ASN, подозреваемых в использовании VPN. Это не полная база VPN или прокси и не поведенческий анализ.

Данные обновляются в реальном времени?

Это не гарантируется. Данные провайдера и обогащение могут меняться в разное время, а результаты API могут кэшироваться до 24 часов. Гарантированной частоты обновления нет.

Связанные инструменты и ресурсы

Коды статуса HTTP

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

OK 200

Запрос выполнен успешно

Неверный запрос 400

Недопустимые параметры

Не авторизован 401

API-ключ или сессия отсутствует либо недействительна.

Требуется оплата 402

Недостаточно кредитов для выполнения этого запроса.

Слишком много запросов 429

Лимит скорости превышен

Тайм-аут шлюза 504

Вышестоящий запрос превысил время ожидания.

Найти IP-адрес