リクエストを出す

POSTリクエスト本文のサンプル

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Airbnb, Inc.",
        "exactMatch": true
    },
    {
        "field": "RegistrantContact.Country",
        "term": "UNITED STATES",
        "exclude": true
    }]
}

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

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

検索語には、以下のいずれか1つの正確なWHOISレコードが含まれます：

共通フィールド

DomainName,
NameServers,
WhoisServer,
Status,
RegistrarName,
Email

Emailフィールドは、1回のクエリでRegistrantContact.Email、AdminContact.Email、BillingContact.Email、TechContact.Emailに対して検索できます。

Registrant Contactフィールド

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

ヘッダー

Advanced Searchのための入力パラメータ

Advanced Searchでは、basicSearchTermsブロックの代わりに、次の形式のadvancedSearchTerms ブロックを使います：

ワイルドカード検索

ワイルドカードのリクエスト数の上限は、1分間に5回です。

特定のフィールドを検索するためにワイルドカードを使用することができます。「domainName」以外の全てのフィールドでは、先頭と末尾のワイルドカードを一緒に使用することはできません。この場合、末尾のワイルドカードは取り除かれます。「domainName」フィールドでは、末尾ワイルドカードと先頭ワイルドカードの両方がある場合、中間ワイルドカードは使用できません。この場合、中間ワイルドカードは取り除かれます。このようなクエリは遅くなる可能性があることにご注意ください。

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "RegistrantContact.Organization",
        "term": "Air*bnb*"
    }]
}

ワイルドカードの使用例

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "DomainName",
        "term": "facebook."
    }]
}

- 返すドメイン名数は0です。

{
    "apiKey": "API_KEY",
    "searchType": "current",
    "mode": "purchase",
    "advancedSearchTerms": [{
        "field": "DomainName",
        "term": "facebook.*"
    }]
}

- 400超のドメイン名を返します。