仕様

パスからデータベースのファイルにアクセスするには、有効な認証情報が必要になります。ユーザー名とパスワードはMy productsページから取得できる個人用APIキーと同じです。

データベースは以下の形式で提供しています。

• Scored Email Domains：メール用ドメイン名について、0～100の信頼度スコア、分類区分、MXレコードの確認状況、MXレコードの最終確認日を収録したリストです。毎日更新されます。
• • 分類区分： 使い捨て（92～100）、 使い捨ての可能性が高い（62～92）、 不明（42～62）、 無料（0～42）
  • Base path: https://download.whoisxmlapi.com/datafeeds
  • 形式： 「disposable-emails-scored.full.%DATE%.csv」および「disposable-emails-scored.full.%DATE%.json」（例：「disposable-emails-scored.full.2026-07-28.csv」）
  • 新しいファイルは毎日13:00 UTCまでに提供されます。
  • サンプル： disposable-emails-scored.full.2026-07-28.sample.csv, disposable-emails-scored.full.2026-07-28.sample.json
  • ファイルのフィールド：

    JSONファイルには、同じフィールドがキャメルケース形式で含まれています：domain、 confidenceScore、classification、 mxSeen、mxChecked、 modelVersion。

    フィールド	型	説明
    domain	string	ドメイン名は小文字で表記します。国際化ドメイン名の場合は、Punycode（xn--）形式を使用します。
    confidence_score	整数、0～100	ドメイン名が使い捨てメール用である可能性を示す、モデルによる信頼度スコアです。値が高いほど、使い捨てメール用である可能性が高いことを意味します。ネームサーバーが継続的に応答しない一部のドメイン名（約0.1%）については、値が空欄になります。
    classification	string	"disposable"、"likely-disposable"、"free"、"unknown"のいずれかの値を取ります。
    mx_seen	ブール値	直近の確認時に、稼働中のメールインフラが確認されたかどうかを示します。値が空欄の場合は、確認が取れていないことを意味し、「メールサーバーが存在しない」という意味ではありません。
    mx_checked	date	MXレコードの稼働状況を最後に確認した日付です。標準形式（YYYY-mm-dd）で記載されます（例：2026-07-22）。
    model_version	string	スコアの算出に使用された評価モデルの識別情報（フィンガープリント）です。 識別情報が付与されたモデルによる再評価がまだ行われていない行では、値が空欄になります。

• Disposable Email Domains：使い捨てメールドメインの日次更新リスト。
• • Base path: https://download.whoisxmlapi.com/datafeeds
  • フォーマット："disposable-emails.full.%DATE%.txt"、例："disposable-emails.full.2020-01-16.txt"。
  • 新しいファイルは毎日01:00 UTCまでに提供されます。
  • 使い捨てメール用ドメイン名の数：162,000件超
  • サンプル： disposable-emails.full.2026-07-28.sample.txt
• Free Email Domains：無料メールドメインの日次更新リスト。
• • Base path: https://download.whoisxmlapi.com/datafeeds
  • フォーマット："free-emails.full.%DATE%.txt"、例："free-emails.full.2020-01-16.txt"。
  • 新しいファイルは毎日01:00 UTCまでに提供されます。
  • フリーメール用ドメイン名の数：192,000件超
  • サンプル： free-emails.full.2026-07-28.sample.txt

データフィード・ファイルのダウンロード方法

推奨する解凍ツール

大容量の圧縮ファイルを扱う場合は、。 gunzipよりもunpigz を使用することをお勧めします。当社の性能テストでは、大容量ファイルの解凍において、 gunzip は unpigzの約2倍の時間がかかる場合があることが確認されています。このため、解凍ツールとしてはunpigzの使用を推奨します。

HTTPS経由でダウンロード

• Base path: https://download.whoisxmlapi.com/datafeeds/
• Usernameとpassword：My productsページで取得できる個人用APIキーと同じです。
• フォルダ：Disposable_Email_Domains

注意：アカウント設定でIPアドレス許可リストを有効にすると、リストに登録されたIPアドレスからのHTTPSダウンロードのみが許可されます。それ以外のリクエストは、403「お客様のIPアドレスは許可リストに登録されていません」というエラーで拒否されます。

FTP経由でダウンロード

• ホスト：datafeeds.whoisxmlapi.com
• ポート：21210
• Username：「user」
• Password：My productsページで取得できる個人用APIキーと同じです。
• ベースパス：ftp://datafeeds.whoisxmlapi.com:21210
• フォルダ：Disposable_Email_Domains

注意：アカウント設定でIPアドレス許可リストを有効にすると、APIコールだけでなく、データフィードのダウンロードにも適用されます。許可リストに登録されていないIPアドレスからのFTP、FTPS、HTTPSリクエストは、403「お客様のIPアドレスは許可リストに登録されていません」というエラーで拒否されます。許可リストを有効にする前に、データフィードをダウンロードするすべてのマシンのIPアドレスを登録してください。

FTPS経由のダウンロード

FTPS接続の詳細につきましては、次のページをご参照ください：https://en.wikipedia.org/wiki/FTPS

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

当社のFTPSサーバーへのアクセスは、通常のFTPサーバーと同じパスとAPIキーで行われます。手順は上記の通りです。FTPS経由で接続するには、FTPクライアントでサポートしている場合は「Requre explicit FTP over TLS」を選択してください。FileZillaの設定例は次の通りです：