seo/
whois

ドメインの現在の登録レコードを照会し、レジストラとIANA ID、登録日・更新日・有効期限、ステータスコード、ネームサーバー、DNSSECの状態を返します。

Whois Lookup API

現在の登録レコード
有効期限
レジストラとIANA ID
ネームサーバー
1リクエストあたり5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Whois Lookup

Whois Lookup はドメインの公開登録レコードを返すもので、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/ のようなサイトのルートを1つ指定します。サブドメインは登録ドメインで照会されます。ページのパスは付けず、ホストだけを渡してください。

Whois Lookup API の使い方

ドメインを1つ送信し、その登録レコードを1行で読み取ります。

  1. {"target": "github.com"} を /v1/seo/whois に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items からレコードを読み取ります。has_more と results.next_cursor は通常のページングのルールに従い、この1行の結果では空のままです。
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 活用のヒント

  • 同じドメインのサブドメインが複数リストにある場合は、先に登録ドメインにまとめてください。どれも同じ行を返し、1リクエストごとに5クレジットかかります。
  • ドメインの運用年数と有効期限までの日数は、published_at と expires_at を collected_at と比べて計算してください。いずれもISO 8601形式のタイムスタンプです。
  • statuses は client transfer prohibited のような小文字のフレーズで返るため、キャメルケースのEPPコードではなくこの形式で照合してください。

Whois Lookup API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。

  • Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
  • Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Backlinks Summary API — 1つのドメイン、サブドメイン、ページの被リンクプロファイルを、権威スコア、被リンク数と参照ドメイン数、スパムスコア、リンク元の内訳とともに1行にまとめます。
  • Domain Overview API — 選んだ国と言語で、1つのドメインのGoogle検索のオーガニック・有料の集計を、ランクインキーワード数、推定トラフィックとその広告費、順位帯、順位変動とともに取得します。
  • Domain Technologies API — ドメインから、ウェブサイトが使っている技術をカテゴリ、権威スコア、SNSプロフィール、公開されている連絡先とともに検出します。

他のプラットフォームを見る

SEOのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Whois Lookup API — よくある質問

Whois Lookup APIは、ドメイン名またはサブドメイン名を指定して、そのドメインの現在の登録レコードを読み取るためのプログラムインターフェースです。レジストラとそのIANA ID、登録日・更新日・有効期限、ステータスコード、ネームサーバー、DNSSECの状態、そしてレコードに記載されている場合は登録者の組織名と国を返します。

.com、.net、.org などの汎用の拡張子に加え、.uk や .ai などの国別の拡張子にも対応しており、各ドメインの公開登録レコードを完全な形で返します。

registrant_organization と registrant_country には、公開レコードに記載されていれば所有者の組織名と国が入ります。レジストラ、日付、ネームサーバーはどのドメインでも返ります。

1リクエストの target に指定できるのは1ドメインなので、ドメインごとに1リクエストずつ送り、各結果から expires_at を集めてください。

1回の照会で1つのドメインを調べ、1行が返り、料金は5クレジットです。