仕様 | DNS Database Download | WhoisXML API

仕様

このデータフィードの利用は、お客様またはお客様の組織のみにライセンスされます。Whois API LLCからの書面による明確な許可なくデータを再販または再ライセンスすることはできません。いかなる違反も法が認める最大限の範囲において起訴されます。

ライセンス契約書はこちらでご確認いただけます: https://www.whoisxmlapi.com/support/WhoisAPIDatabaseSLA.pdf.

FAQs

  • データベースダウンロードプロダクト用データディクショナリ: HTML, ODT, PDF
  • DNSレコードのタイプごとの用途に関する説明はこちら

データベースには3つの形式があり、A、AAAA、MX、NS、TXT、CNAME、SOAおよびPTRレコードが含まれます。CSVでダウンロードできます。

  • Full databases — 指定された日付のDNSレコード(A、AAAA、MX、NS、TXT、CNAME、SOA、PTR)の完全なデータベースを、統一的な一貫したCSV形式で提供します。ファイル名は以下の形式になっています:
    "dns_database.%DATE%.full.csv.gz"
    "dns_aaaa_database.%DATE%.full.csv.gz"
    "dns_mx_database.%DATE%.full.csv.gz"
    "dns_ns_database.%DATE%.full.csv.gz",
    "dns_txt_database.%DATE%.full.csv.gz",
    "dns_cname_database.%DATE%.full.csv.gz",
    "dns_soa_database.%DATE%.full.csv.gz",
    "dns_ptr_database.%DATE%.full.csv.gz",
    e.g. "dns_database.2021-12-01.full.csv.gz".
  • Incremental databases — DNSレコードの全データベースにおける、前期と比較した差分。前週/前月から追加、ドロップおよび変更されたレコードが含まれます。ファイル名は以下の形式になっています:
    "dns_database.%DATE%.monthly.diff.csv.gz"
    "dns_database.%DATE%.weekly.diff.csv.gz"
    "dns_aaaa_database.%DATE%.monthly.diff.csv.gz"
    "dns_aaaa_database.%DATE%.weekly.diff.csv.gz"
    "dns_mx_database.%DATE%.monthly.diff.csv.gz",
    "dns_mx_database.%DATE%.weekly.diff.csv.gz",
    "dns_ns_database.%DATE%.monthly.diff.csv.gz",
    "dns_ns_database.%DATE%.weekly.diff.csv.gz",
    "dns_txt_database.%DATE%.monthly.diff.csv.gz",
    "dns_txt_database.%DATE%.weekly.diff.csv.gz",
    "dns_cname_database.%DATE%.monthly.diff.csv.gz",
    "dns_cname_database.%DATE%.weekly.diff.csv.gz",
    "dns_soa_database.%DATE%.monthly.diff.csv.gz",
    "dns_soa_database.%DATE%.weekly.diff.csv.gz",
    "dns_ptr_database.%DATE%.monthly.diff.csv.gz",
    "dns_ptr_database.%DATE%.weekly.diff.csv.gz",
    e.g. "dns_database.2021-12-01.weekly.diff.csv.gz".
  • Lite databases — 学術的な目的で作成された、ある日付のA DNSレコードの部分的なデータベース。全データベースの5%程度が含まれています。ファイル名は以下の形式になっています:
    "dns_database.%DATE%.academic.csv.gz" e.g. "dns_database.2021-12-01.academic.csv.gz".
  • Daily updates — 指定された日付の前日中に追加されたDNSレコード(A、AAAA、MX、NS、TXT、CNAME、SOA、PTR)を、統一的な一貫したCSV形式で収録しています。ファイルはdaily_datafeedサブディレクトリに格納されており、ファイル名は以下の形式になています:
    "daily_datafeed/dns_database.%DATE%.daily.csv.gz"
    "daily_datafeed/dns_aaaa_database.%DATE%.daily.csv.gz"
    "daily_datafeed/dns_mx_database.%DATE%.daily.csv.gz"
    "daily_datafeed/dns_ns_database.%DATE%.daily.csv.gz",
    "daily_datafeed/dns_txt_database.%DATE%.daily.csv.gz",
    "daily_datafeed/dns_cname_database.%DATE%.daily.csv.gz",
    "daily_datafeed/dns_soa_database.%DATE%.daily.csv.gz",
    "daily_datafeed/dns_ptr_database.%DATE%.daily.csv.gz",
    e.g. "daily_datafeed/dns_database.2021-12-01.daily.csv.gz".

サンプル

HTTPSによるダウンロード

FTPによるダウンロード

  • ホスト: datafeeds.whoisxmlapi.com
  • ポート: 21210
  • ユーザー名: 'user'
  • パスワード: equal to your personal API Key which you can obtain from the My Products page.
  • ベースパス: ftp://datafeeds.whoisxmlapi.com:21210
  • フォルダ: DNS_Database_Download

FTPSによるダウンロード

FTPS接続について詳しくはこちら:https://en.wikipedia.org/wiki/FTPS.

当社のFTPサーバーは、明示的なFTP over TLS暗号化をサポートしています。安全な通信のため、明示的なFTP over TLS暗号化を使用するようにお客様のFTPクライアントを設定することができます。:

当社のFTPSサーバーは、通常のFTPサーバーと同じパスとAPIキーを使ってアクセスします。その方法は、上記のとおりです。FTPSによる接続において、お客様のFTPクライアントでサポートしている場合は「Require explicit FTP over TLS」暗号化オプションを選択してください。以下はFileZillaの設定例です:

explicit FTP over TLS encryption

平均ファイルサイズ

A ファイル

ファイルの内容 ファイル名サフィックス 圧縮ファイルの平均サイズ 解凍したファイルの平均サイズ
学術目的の部分データベース .academic 4.6GiB 17.0GiB
週次の全データベースのエクスポート .weekly.full 8.9GiB 34.0GiB
週次の全データベースの差分 .weekly.diff 1.0GiB 5.2GiB
月次の全データベースの差分 .monthly.diff 3.2GiB 15.4GiB
前日に追加されたレコード .daily 305.1MiB 1.0GiB

MX ファイル

ファイルの内容 ファイル名サフィックス 圧縮ファイルの平均サイズ 解凍したファイルの平均サイズ
週次の全データベースのエクスポート .weekly.full 3.5GiB 20.9GiB
週次の全データベースの差分 .weekly.diff 64.3MiB 818.1MiB
月次の全データベースの差分 .monthly.diff 274.5MiB 3.3GiB
前日に追加されたレコード .daily 112.1MiB 777.9MiB

NS ファイル

ファイルの内容 ファイル名サフィックス 圧縮ファイルの平均サイズ 解凍したファイルの平均サイズ
週次の全データベースのエクスポート .weekly.full 6.9GiB 42.5GiB
週次の全データベースの差分 .weekly.diff 175.4MiB 1.3GiB
月次の全データベースの差分 .monthly.diff 740.7MiB 5.3GiB
前日に追加されたレコード .daily 189.3MiB 1.2GiB

TXT ファイル

ファイルの内容 ファイル名サフィックス 圧縮ファイルの平均サイズ 解凍したファイルの平均サイズ
週次の全データベースのエクスポート .weekly.full 4.2GiB 15.8GiB
週次の全データベースの差分 .weekly.diff 120.8MiB 547.3MiB
月次の全データベースの差分 .monthly.diff 496.7MiB 2.2GiB
前日に追加されたレコード .daily 129.2MiB 555.8MiB

CNAME ファイル

ファイルの内容 ファイル名サフィックス 圧縮ファイルの平均サイズ 解凍したファイルの平均サイズ
週次の全データベースのエクスポート .weekly.full 904.1miB 3.7GiB
週次の全データベースの差分 .weekly.diff 25.2MiB 216.5MiB
月次の全データベースの差分 .monthly.diff 105.0MiB 857.8MiB
前日に追加されたレコード .daily 49.1MiB 194.6MiB

SOA ファイル

ファイルの内容 ファイル名サフィックス 圧縮ファイルの平均サイズ 解凍したファイルの平均サイズ
週次の全データベースのエクスポート .weekly.full 8.8GiB 50.5GiB
週次の全データベースの差分 .weekly.diff 1.3GiB 8.5GiB
月次の全データベースの差分 .monthly.diff 4.0GiB 26.0GiB
前日に追加されたレコード .daily 189.3MiB 1.0GiB

AAAA ファイル

ファイルの内容 ファイル名サフィックス 圧縮ファイルの平均サイズ 解凍したファイルの平均サイズ
週次の全データベースのエクスポート .weekly.full 1.7GiB 7.4GiB
週次の全データベースの差分 .weekly.diff 206.3MiB 1.2GiB
月次の全データベースの差分 .monthly.diff 621.7MiB 3.3GiB
前日に追加されたレコード .daily 45.3MiB 174.0MiB

PTR ファイル

ファイルの内容 ファイル名サフィックス 圧縮ファイルの平均サイズ 解凍したファイルの平均サイズ
週次の全データベースのエクスポート .weekly.full 63.7MiB 354.4MiB
週次の全データベースの差分 .weekly.diff 52.5MiB 302.7MiB
月次の全データベースの差分 .monthly.diff 120.3MiB 692.5MiB
前日に追加されたレコード .daily 20.1MiB 105.1MiB

出力の構造とフィールドの説明

A ファイル

  • 構造: <DOMAIN>,<LAST_UPDATE_TIMESTAMP>,<IP1> <IP2> ... <IPn>
  • 例: zs12p1.gotoip1.com.cname.yunjiasu-cdn.net,1530959456,162.159.210.99 162.159.211.99
DOMAIN
ドメイン名またはサブドメイン名
LAST_UPDATE
現在のレコードの最終訪問/更新のUNIXタイムスタンプ。複数のIPアドレスがある場合、タイムスタンプはそれら全てに対応します。
IP1, IP2, IPn
ドメイン名に関連付けられたIPアドレスのリスト(スペース区切り)。

AAAA ファイル

  • 構造: <DOMAIN>,<LAST_UPDATE_TIMESTAMP>,<IP1> <IP2> ... <IPn>
  • 例: 212120--jekyllrb.netlify.app,1647929159,2604:a880:400:d0::1738:6301 2604:a880:400:d0::1b6b:7051
DOMAIN
ドメイン名またはサブドメイン名
LAST_UPDATE
現在のレコードの最終訪問/更新のUNIXタイムスタンプ。複数のIPアドレスがある場合、タイムスタンプはそれら全てに対応します。
IP1, IP2, IPn
ドメイン名に関連付けられたIPアドレスのリスト(スペース区切り)。

MX ファイル

  • 構造:
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<PRIORITY>,<MX1>
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<PRIORITY>,<MX2>
    - <DOMAIN-B>,<LAST_UPDATE_TIMESTAMP>,<PRIORITY>,<MX1>
    - ...
  • 例:
    - 003vendor.com,1608996228,20,alt1.aspmx.l.google.com
    - 003vendor.com,1608996228,20,alt2.aspmx.l.google.com
DOMAIN
ドメイン名またはサブドメイン名
LAST_UPDATE
現在のレコードの最終訪問/更新のUNIXタイムスタンプ
PRIORITY
優先するメールサーバーを指定
MX
そのドメイン名に関連づけられたMXレコード

NS ファイル

  • 構造:
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<NS1>
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<NS2>
    - <DOMAIN-B>,<LAST_UPDATE_TIMESTAMP>,<NS1>
    - ...
  • 例:
    - 0001.cn,1608996268,dns1.hichina.com
    - 0001.cn,1608996268,dns2.hichina.com
DOMAIN
ドメイン名またはサブドメイン名
LAST_UPDATE
現在のレコードの最終訪問/更新のUNIXタイムスタンプ
NS
そのドメイン名に関連づけられたNSレコード

TXT ファイル

  • 構造:
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<TXT1>
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<TXT2>
    - <DOMAIN-B>,<LAST_UPDATE_TIMESTAMP>,<TXT1>
    - ...
  • 例:
    - 0--00.holiest.science,1619741985,|v=spf1 ip4:67.225.166.63 +a +mx +ip4:67.225.166.41 ~all!
    - 0--00.holiest.science,1619741985,|v=spf1 ip4:67.225.166.63 +a +mx +ip4:67.225.166.41 ~alla
DOMAIN
ドメイン名またはサブドメイン名
LAST_UPDATE
現在のレコードの最終訪問/更新のUNIXタイムスタンプ
TXT
そのドメイン名に関連づけられたTXTレコード

CNAME ファイル

  • 構造:
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<CNAME1>
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<CNAME2>
    - <DOMAIN-B>,<LAST_UPDATE_TIMESTAMP>,<CNAME1>
    - ...
  • 例:
    - 0-131-3-149.rackcentre.redstation.net.uk,1619742251,redstation.com
    - 0-132-3-149.rackcentre.redstation.net.uk,1619741776,redstation.com
DOMAIN
ドメイン名またはサブドメイン名
LAST_UPDATE
現在のレコードの最終訪問/更新のUNIXタイムスタンプ
CNAME
そのドメイン名に関連づけられたCNAMEレコード

SOA ファイル

  • 構造:
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<SOA1>
    - <DOMAIN-A>,<LAST_UPDATE_TIMESTAMP>,<SOA2>
    - <DOMAIN-B>,<LAST_UPDATE_TIMESTAMP>,<SOA1>
    - ...
  • 例:
    - 0-rings.com,1619741730,NS25.DOMAINCONTROL.com dns.jomax.net 2018091300 28800 7200 604800 3600
    - 0-rings.com,1619741730,NS25.domaincontrol.com dns.jomax.net 2018091300 28800 7200 604800 3600
DOMAIN
ドメイン名またはサブドメイン名
LAST_UPDATE
現在のレコードの最終訪問/更新のUNIXタイムスタンプ
SOA
そのドメイン名に関連づけられたSOAレコード

PTR ファイル

  • 構造:
    - <IP-A>,<LAST_UPDATE_TIMESTAMP>,<PTR1>
    - <IP-A>,<LAST_UPDATE_TIMESTAMP>,<PTR2>
    - <IP-B>,<LAST_UPDATE_TIMESTAMP>,<PTR1>
    - ...
  • 例:
    - 1.0.135.155,1661516953,node-1i3.pool-1-0.dynamic.totinternet.net
    - 1.0.0.1,1661724824,one.one.one.one
IP
IP address.
LAST_UPDATE
現在のレコードの最終訪問/更新のUNIXタイムスタンプ
PTR
そのIPアドレスに関連づけられたPTRレコード