依頼を行う

概要

Typosquatting API は、タイポスクワッティングドメインを検出・調査するための 4 つのエンドポイントを提供しています。すべてのリクエストは HTTP GET で行われます。

1. ドメインを確認する

そのドメインが属するタイポスクワッティンググループを特定する。

1回のリクエストにつき、DRSクレジットが1ポイント消費されます。

取得 https://typosquatting.whoisxmlapi.com/api/v1/checkDomain?apiKey=YOUR_API_KEY&domainName=amoreresidences.com

入力パラメータ

APIキー

必須です。「マイプロダクト」ページで個人用APIキーを取得してください。

ドメイン名

必須。タイポスクワッティング・グループへの所属を確認するドメイン名。UTF-8形式の任意の文字列を受け付けます。

出力形式

オプション。応答の出力形式。

有効な値:JSON|XML

デフォルト:JSON

出力例

[
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "totalNoOfGrpMembers": 13
    }
]

出力フィールド

日付
タイポスクワッティング集団が発見された日付(YYYY-MM-DD形式)。
グループ番号
指定された日付に対するタイポスクワッティング・グループ識別子。
グループメンバーの総数
このタイポスクワッティング・グループに含まれるドメインの総数。

2. ドメインの確認(詳細情報付き)

指定されたドメインが属するすべてのグループ内の全ドメインについて、詳細なデータを取得します。これは単一ドメインに対するクエリとしては最も詳細なもので、各グループメンバーの完全なWHOIS情報および登録詳細が返されます。

1回のリクエストにつき5 DRSクレジットが必要です。

取得 https://typosquatting.whoisxmlapi.com/api/v1/checkDomainEnriched?apiKey=YOUR_API_KEY&domainName=iwin.exposed

入力パラメータ

APIキー

必須です。「マイプロダクト」ページで個人用APIキーを取得してください。

ドメイン名

必須。確認するドメイン名。UTF-8形式の文字列であれば何でも指定可能です。例として挙げられているドメイン「iwin.exposed」は、複数のグループに表示されるため、テストに便利です。

出力形式

オプション。応答の出力形式。

有効な値:JSON|XML

デフォルト:JSON

出力例

拡張されたレコードのJSON配列を返します。各フィールドの詳細については、以下の「拡張出力フィールド」のセクションを参照してください。

3. グループに参加する

特定のタイポスクワッティング・グループに属するすべてのドメインを取得する(基本フィールド)。

1回のリクエストにつき5 DRSクレジットが必要です。

取得 https://typosquatting.whoisxmlapi.com/api/v1/getGroup?apiKey=YOUR_API_KEY&date=2022-05-10&groupNumber=1

入力パラメータ

APIキー

必須です。「マイプロダクト」ページで個人用APIキーを取得してください。

日付

必須。検出日(YYYY-MM-DD形式)。2020-07-01以降でなければなりません。

グループ番号

必須。タイポスクワッティングのグループ番号(整数)。

出力形式

オプション。応答の出力形式。

有効な値:JSON|XML

デフォルト:JSON

出力例

[
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "groupMemberNumber": 1,
        "totalNoOfGrpMembers": 13,
        "domain": "example1.com",
        "domainUtf": "example1.com"
    },
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "groupMemberNumber": 2,
        "totalNoOfGrpMembers": 13,
        "domain": "example2.com",
        "domainUtf": "example2.com"
    }
]

出力フィールド

日付
タイポスクワッティング集団が発見された日付(YYYY-MM-DD形式)。
グループ番号
タイポスクワッティングのグループ識別子。
グループメンバー数
グループ内でのメンバーの順位(昇順)。
グループメンバーの総数
このグループに含まれるドメインの総数。
ドメイン
ドメイン名(ASCII)。
domainUtf
UTF-8 エンコードされたドメイン名(国際化ドメイン名に有用)。

4. グループを取得(拡張)

特定のタイポスクワッティング・グループに属するすべてのドメインを、詳細なWHOIS情報および登録データと共に取得します。

1回のリクエストにつき5 DRSクレジットが必要です。

取得 https://typosquatting.whoisxmlapi.com/api/v1/getGroupEnriched?apiKey=YOUR_API_KEY&date=2022-05-10&groupNumber=1

入力パラメータ

APIキー

必須です。「マイプロダクト」ページで個人用APIキーを取得してください。

日付

必須。検出日(YYYY-MM-DD形式)。2020-07-01以降でなければなりません。

グループ番号

必須。タイポスクワッティングのグループ番号(整数)。

出力形式

オプション。応答の出力形式。

有効な値:JSON|XML

デフォルト:JSON

出力例

拡張されたレコードのJSON配列を返します。各フィールドの詳細については、以下の「拡張出力フィールド」のセクションを参照してください。

拡張出力フィールド

エンリッチされたエンドポイント(checkDomainEnrichedgetGroupEnriched)は、各レコードについて以下のフィールドを返します:

日付
タイポスクワッティング集団が発見された日付(YYYY-MM-DD形式)。
グループ番号
タイポスクワッティングのグループ識別子。
グループメンバー数
グループ内におけるそのメンバーの立場。
グループメンバーの総数
このグループに含まれるドメインの総数。
ドメイン
ドメイン名(ASCII)。
domainUtf
UTF-8エンコードされたドメイン名。
登録者名
WHOISレコードに記載されている登録者の氏名。
登録者組織
登録者の所属組織。
登録者の国
登録者の国。
登録者州
登録者の州または州。
登録者の都市
登録者の居住地。
登録者のメールアドレス
登録者のメールアドレス。
登録機関名
ドメイン登録業者の名称。
レジストラIANAID
レジストラのIANA ID。
whoisサーバー
そのドメインのWHOISサーバー。
ネームサーバー
そのドメインに関連付けられたネームサーバー。
ステータス
ドメインのステータスコード(例:clientTransferProhibited)。
作成日
レジストラが報告するドメインの作成日。
更新日
レジストラが報告するドメインの最終更新日。
有効期限
レジストラから報告されたドメインの有効期限。
standardRegCreatedDate
YYYY-MM-DD HH:MM:SS形式で標準化されたドメイン作成日。
標準更新日
YYYY-MM-DD HH:MM:SS形式で標準化されたドメインの最終更新日。
標準の有効期限
YYYY-MM-DD HH:MM:SS形式で標準化されたドメインの有効期限。
ips
そのドメインに関連付けられているIPアドレス。

価格

各エンドポイントは、リクエストが成功するたびに、一定数のDRSクレジットを差し引きます:

登録後、アカウントの有効化には最大1分ほどかかります。

無料アクセス

登録後、自動的に500 DRSクレジットまで利用できる無料プランが適用されます。

利用制限とリクエストのスロットリング

1秒あたりのリクエスト数は最大30件です。この制限を超えた場合、 次のになるまで、それ以降のリクエストは拒否されます。

このAPIは、専用のロードバランサーとプレミアムエンドポイントと組み合わせて利用することも可能で、 当社のプレミアムAPIサービスおよびエンタープライズAPIパッケージの一環として、より高速なクエリ処理を実現します。