seo/
whois

도메인의 현재 등록 기록을 조회해 레지스트라와 IANA ID, 등록·수정·만료 날짜, 상태 코드, 네임서버, DNSSEC 상태를 반환합니다.

Whois Lookup API

현재 등록 기록
만료일
레지스트라와 IANA ID
네임서버
요청당 5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Whois Lookup

WHOIS 조회는 도메인의 공개 등록 기록을 돌려주며, IANA ID가 붙은 레지스트라, 도메인의 등록일, 최근 수정일, 만료 예정일, 상태 코드, 네임서버, DNSSEC 상태와 함께 기록에 나와 있는 경우 등록자 조직과 국가까지 담깁니다. 이 날짜와 설정을 보면 도메인이 얼마나 오래됐는지, 등록이 언제 끝나는지, 이전 잠금이 걸려 있는지, DNS가 어디에 위임되어 있는지 알 수 있어 만료 모니터링, 거래처 점검, 도메인 포트폴리오 감사에 활용됩니다.

Whois Lookup API 주요 기능

  • 요청 시점의 최신 기록조회할 때마다 요청 시점의 등록 기록을 읽으므로, 날짜와 상태는 요청한 순간의 도메인 상태를 그대로 반영합니다.
  • 등록일, 수정일, 만료일published_at, updated_at, expires_at 값은 최초 등록부터 현재 만료일까지의 등록 이력을 ISO 8601 형식으로 알려 줍니다.
  • IANA ID가 붙은 레지스트라registrar 값은 도메인을 관리하는 회사 이름이고, registrar_iana_id 값은 레지스트라 목록과 대조할 수 있는 IANA 번호입니다.
  • 상태 코드, 네임서버, 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"}을 /v1/seo/whois로 POST합니다.
  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 값은 카멜 표기 EPP 코드가 아니라 client transfer prohibited처럼 반환되는 소문자 문구로 대조하세요.

Whois Lookup API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • 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 — 자주 묻는 질문

Whois Lookup API는 도메인이나 서브도메인 이름을 입력받아 도메인의 현재 등록 기록을 읽어 오는 프로그래밍 인터페이스입니다. 레지스트라와 IANA ID, 등록·수정·만료 날짜, 상태 코드, 네임서버, DNSSEC 상태와 함께 기록에 나와 있는 경우 등록자 조직과 국가를 반환합니다.

.com, .net, .org 같은 일반 확장자는 물론 .uk, .ai 같은 국가 확장자도 조회할 수 있으며, 도메인마다 공개 등록 기록 전체를 반환합니다.

공개 기록에 소유자 정보가 나와 있으면 registrant_organization과 registrant_country 값에 소유자의 조직과 국가가 담깁니다. 레지스트라, 날짜, 네임서버는 모든 도메인에서 반환됩니다.

요청마다 target 값에 도메인 하나를 넣으므로, 도메인마다 요청을 하나씩 제출하고 각 결과에서 expires_at 값을 모으세요.

조회마다 도메인 하나를 확인해 행 하나를 반환하며 5 크레딧입니다.