リクエストを出す | ドキュメント | Domains & Subdomains Discovery API | WhoisXML API

リクエストを出す

APIエンドポイント

POST https://domains-subdomains-discovery.whoisxmlapi.com/api/v1
アカウントの登録後、有効化に1分ほどかかります。

Postman Collection

Postmanは、GUIからAPIへのリクエストを可能にするデスクトップおよびウェブのアプリケーションです。APIの機能を活用する際、およびアプリケーションのトラブルシューティングにあたっては、PostmanとWhoisXML APIエンドポイントのご利用をお勧めします。

WhoisXML API Postman Collectionは、以下のリンクから入手できます:

コレクションの環境はあらかじめ設定されたものです。各リクエストを起動するためには、api_key変数を設定する必要があります。 個人用API KEYは、My productsページで取得してください。APIに関するご質問は、こちらにお送りください。

POSTリクエストボディのサンプル:ドメイン名のみ(1 DRSクレジット)

サブドメインゾーンを除くドメインゾーンとTLDゾーンで指定した検索語に合致するドメイン名のみを返します。

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.*"
        ]
    }
}

POSTリクエストボディのサンプル:サブドメインのみ(10 DRSクレジット)

ドメインゾーンとTLDゾーンを除くサブドメインゾーンで指定された検索語に合致するサブドメインのみを返します。

{
    "apiKey": "YOUR_API_KEY",
    "subdomains": {
        "include": [
            "adidas*"
        ],
        "exclude": [
            "*shoes*"
        ]
    }
}

POSTリクエストボディのサンプル:ドメイン名とサブドメイン(11 DRSクレジット)

ホスト名全体で指定された検索語に合致するドメイン名 とサブドメインを返します。

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.com"
        ]
    },
    "subdomains": {
        "include": [
            "aws*"
        ],
        "exclude": [
            "*portal*",
            "*beta*"
        ]
    }
}

1回のリクエストで最大4つの検索語を指定することができます。

入力パラメータ

apiKey

必須My productsページでAPIキーを取得してください。

[domains|subdomains].include

必須。検索語の配列。最大4項目。大文字と小文字は区別されません。

[domains|subdomains].exclude

任意。除外する検索語の配列。最大4項目。大文字と小文字は区別されません。

sinceDate

任意。「YYYY-MM-DD」形式の日付。

存在する場合、指定された日付以降に発見されたドメイン/サブドメインを検索します。

outputFormat

任意。応答の出力形式。

使用可能な値:JSON | XML

初期値:JSON

Domains & Subdomains Discovery APIへのリクエスト1回分の費用:

  • ドメイン名のみ:1 DRSクレジット
  • サブドメインのみ:10 DRSクレジット
  • ドメイン名とサブドメイン:11 DRSクレジット

ワイルドカード検索

検索にはワイルドカードを使用できます。このようなクエリは処理速度が遅くなる可能性があります。

{
    "apiKey": "YOUR_API_KEY",
    "domains": {
        "include": [
            "amazon.*"
        ]
    },
    "subdomains": {
        "include": [
            "aws*"
        ],
        "exclude": [
            "*portal*",
            "*beta*"
        ]
    }
}

無料アクセス

アカウント登録後、上限500 DRSクレジットの無料サブスクリプションプランが自動的に適用されます。

使用量の上限とリクエストのスロットリング

1秒あたりのリクエスト数の上限は30件です。この上限を超えた場合、 次のまでリクエストは拒否されます。

プレミアムAPIサービスおよびエンタープライズAPIパッケージでご提供するAPIでは、専用のロードバランサーとプレミアムエンドポイントにより、さらに高速なクエリが可能です。