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
Отправьте один домен и прочитайте его регистрационную запись одной строкой.
- Отправьте {"target": "github.com"} методом POST на /v1/seo/whois.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Прочитайте запись из 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.
Связанные API
Помимо 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 — Определяйте технологии сайта по его домену: категории, ранг авторитета, профили в соцсетях и опубликованные контакты.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Competitor Domains API
- Traffic Estimate API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API