seo/
whois

Проверяйте актуальную регистрационную запись домена: регистратор и его IANA ID, даты регистрации, обновления и окончания, коды статусов, DNS-серверы и состояние DNSSEC.

Whois Lookup API

Актуальная регистрационная запись
Дата окончания
Регистратор и IANA ID
DNS-серверы
5 кредитов за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Whois Lookup

Whois Lookup возвращает публичную регистрационную запись домена: регистратора с его IANA ID, даты регистрации, последнего обновления и окончания, коды статусов, DNS-серверы и состояние DNSSEC, а также организацию и страну регистранта, если они указаны в записи. Эти даты и настройки показывают, сколько лет домену, когда истекает его регистрация, защищен ли он от трансфера и куда делегирован его DNS, что помогает следить за сроками, проверять поставщиков и проводить аудит портфеля доменов.

Возможности Whois Lookup API

  • Актуальная запись на момент запросаКаждая проверка читает регистрационную запись в момент запроса, поэтому даты и статусы отражают состояние домена на момент обращения.
  • Даты регистрации, обновления и окончанияpublished_at, updated_at и expires_at дают хронологию регистрации в ISO 8601 — от первой регистрации до текущей даты окончания.
  • Регистратор с IANA IDregistrar называет компанию, которая управляет доменом, а registrar_iana_id дает ее номер IANA для сверки со списками регистраторов.
  • Коды статусов, DNS-серверы и DNSSECstatuses перечисляет коды статусов домена, например client transfer prohibited, nameservers показывает, куда делегирован DNS, а is_dnssec_signed сообщает, включен ли DNSSEC.
  • Поддомены сводятся к зарегистрированному доменуХост вроде docs.example.com проверяется по example.com, так что имя хоста из ссылки или адреса электронной почты можно отправить как есть.

Параметры Whois Lookup API

ПараметрыОбязательныйОписание
targetОбязательныйОдин домен, например github.com, или корень сайта, например https://github.com/. Поддомены проверяются по своему зарегистрированному домену; передавайте только хост, без пути страницы.

Как использовать Whois Lookup API

Отправьте один домен и прочитайте его регистрационную запись одной строкой.

  1. Отправьте {"target": "github.com"} методом POST на /v1/seo/whois.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Прочитайте запись из results.items; has_more и results.next_cursor подчиняются обычным правилам пагинации и для этой единственной строки остаются пустыми.
curl -X POST "https://api.socq.ai/v1/seo/whois" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"github.com"}'

Сценарии использования Whois Lookup API

  • Мониторинг окончания регистрации: Сохраняйте expires_at для своих или интересующих вас доменов и планируйте проверки заранее, чтобы вовремя продлить регистрацию или не пропустить освобождение домена.
  • Проверка возраста домена поставщика: Сравните published_at с сегодняшней датой, чтобы понять, сколько существует домен поставщика или нового контакта, прежде чем ему доверять.
  • Аудит портфеля доменов: Сопоставьте registrar, nameservers, is_dnssec_signed и statuses по всем своим доменам, чтобы найти домены не у того регистратора, без DNSSEC или без блокировки трансфера.
  • Обнаружение изменений регистрации: Следите за updated_at вместе со statuses и nameservers, чтобы заметить изменение записи домена, например после смены регистратора или переноса DNS.

Практические советы по Whois Lookup API

  • Если в списке несколько поддоменов одного домена, сначала сведите их к зарегистрированному домену: каждый вернет ту же строку по 5 кредитов за запрос.
  • Вычисляйте возраст домена и число дней до окончания по published_at и expires_at относительно collected_at — все это метки времени ISO 8601.
  • Сопоставляйте statuses с фразами в нижнем регистре, в которых они возвращаются, например client transfer prohibited, а не с EPP-кодами в camelCase.

Помимо Whois Lookup API, используйте эти API, когда нужен другой тип публичных данных SEO.

  • Google Organic SERP API — Получайте одну актуальную страницу выдачи Google по запросу и рынку: нормализованные целевые URL, позиции, типы элементов и полные данные результатов.
  • Keyword Difficulty API — Сравнивайте сложность продвижения в органической выдаче для пакета ключевых слов и получайте нормализованную оценку для каждого доступного слова.
  • Keyword Overview API — Дополняйте пакет ключевых слов доступными данными о спросе, конкуренции в платной выдаче, сложности, ежемесячной частотности и интенте.
  • Backlinks Summary API — Сводите ссылочный профиль домена, поддомена или страницы в одну строку: ранг авторитета, итоги по обратным ссылкам и ссылающимся доменам, спам-оценка и разбивки источников.
  • Domain Overview API — Получайте органические и платные итоги домена в Google для выбранной страны и языка: ключевые слова, трафик и его рекламная стоимость, диапазоны и изменения позиций.
  • Domain Technologies API — Определяйте технологии сайта по его домену: категории, ранг авторитета, профили в соцсетях и опубликованные контакты.

Другие платформы

Объединяйте данные SEO с публичными данными других поддерживаемых соцсетей.

Whois Lookup API — FAQ

Whois Lookup API — это программный интерфейс для чтения актуальной регистрационной записи домена по имени домена или поддомена. Он возвращает регистратора и его IANA ID, даты регистрации, обновления и окончания, коды статусов, DNS-серверы, состояние DNSSEC, а также организацию и страну регистранта, если они указаны в записи.

Поддерживаются .com, .net, .org и другие общие зоны, а также национальные зоны, например .uk и .ai, и для каждого домена возвращается полная публичная регистрационная запись.

registrant_organization и registrant_country содержат организацию и страну владельца, когда они указаны в публичной записи, а регистратор, даты и DNS-серверы возвращаются для каждого домена.

Каждый запрос принимает один домен в target, поэтому отправляйте по запросу на домен и собирайте expires_at из каждого результата.

Каждая проверка охватывает один домен, возвращает одну строку и стоит 5 кредитов.