高度なAPIドキュメント | ドキュメント | Registrant Alert API | WhoisXML API

リクエストを出す

APIエンドポイント

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

検索結果は10,000レコードに制限されています。より適切な検索結果を得たい場合は、検索クエリを最適化するか、高度な検索を使用してみてください。

Postman Collection

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

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

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

POSTリクエスト本文の例

{
    "apiKey": "API_KEY",
    "sinceDate": "2019-04-20",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Airbnb, Inc.",
        "exactMatch": true
    },
    {
        "field": "RegistrantContact.Country",
        "term": "UNITED STATES"
    }]
}

ベーシックな検索では、より少ない設定で、より広範な検索結果が得られます。高度な検索では、特定のWHOISフィールドを検索することができます。

1回のリクエストで最大4つの検索語を指定することができます。複数の単語を指定すると、その全てに合致するドメイン名が出力されます。

検索語には、ドメイン名のWHOISレコードの正確なフィールド、すなわち以下のいずれかが含まれます:

共通フィールド

メール

Emailフィールドにより、RegistrantContact.EmailAdminContact.EmailBillingContact.EmailTechContact.Email1回のクエリで検索できます。

RegistrantContactフィールド

RegistrantContact.City, RegistrantContact.Country, RegistrantContact.Email, RegistrantContact.Fax, RegistrantContact.FaxExtension, RegistrantContact.Name, RegistrantContact.Organization, RegistrantContact.PostalCode, RegistrantContact.State, RegistrantContact.StreetAddress, RegistrantContact.Telephone, RegistrantContact.TelephoneExtension

Admin contactフィールド

AdminContact.City, AdminContact.Country, AdminContact.Email, AdminContact.Fax, AdminContact.FaxExtension, AdminContact.Name, AdminContact.Organization, AdminContact.PostalCode, AdminContact.State, AdminContact.StreetAddress, AdminContact.Telephone, AdminContact.TelephoneExtension

Billing contactフィールド

BillingContact.City, BillingContact.Country, BillingContact.Email, BillingContact.Fax, BillingContact.FaxExtension, BillingContact.Name, BillingContact.Organization, BillingContact.PostalCode, BillingContact.State, BillingContact.StreetAddress, BillingContact.Telephone, BillingContact.TelephoneExtension

Technical contactフィールド

TechContact.City, TechContact.Country, TechContact.Email, TechContact.Fax, TechContact.FaxExtension, TechContact.Name, TechContact.Organization, TechContact.PostalCode, TechContact.State, TechContact.StreetAddress, TechContact.Telephone, TechContact.TelephoneExtension

ヘッダー

X-Authentication-Token

APIコールには、このヘッダーまたはapiKeyパラメータを使用できます。

My productsページで個人用APIキーを取得してください。

高度な検索のための入力パラメータ

高度な検索では、basicSearchTermsブロックの代わりに、以下の形式のadvancedSearchTermsブロックを使用します:

advancedSearchTerms.field

必須。どのWHOISフィールドで検索するか。

advancedSearchTerms.term

必須。検索文字列。大文字小文字は区別されません。

advancedSearchTerms.exactMatch

任意。ブール値。フィールドが検索語と完全に一致するかどうか。 falseの場合、そのフィールドには部分文字列として検索語を含むことができます。

使用可能な値:falsetrue

初期値:false

現在、このパラメータは以下のフィールドでのみサポートされています: RegistrantContact.Name, RegistrantContact.Organization, RegistrantContact.StreetAddress, AdminContact.Name, AdminContact.Organization, AdminContact.StreetAddress, BillingContact.Name, BillingContact.Organization, BillingContact.StreetAddress, TechContact.Name, TechContact.Organization, TechContact.Street

上記以外のフィールドでは無視され、trueと解釈されます。