リクエストを出す | ドキュメント | IP Netblocks API | WhoisXML API

リクエストを出す

APIエンドポイント

GET https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&ip=8.8.8.8
GET https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&ip=2001:0000:4136:e378::
GET https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&ip=8.8.8.8&mask=16
GET https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&org[]=apple&org[]=germany
GET https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&asn=2544
登録後、アカウントの有効化に1分ほどかかります。

Postman Collection

Postmanは、GUIからAPIへのリクエストを可能にするデスクトップ/ウェブアプリケーションです。APIの機能を調べる際には、PostmanとWhoisXMLのAPIエンドポイントの使用をお勧めします。また、アプリケーションのトラブルシューティングにおいても、Postmanの使用を推奨します。

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

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

入力パラメータ:必須

apiKey

My productsページで個人用API KEYを取得します。

ip

入力欄は、iporgasnのいずれか1つを必須とします。入力に応じて、IPv4/IPv6アドレスまたはCIDRで範囲を取得します。また、CIDRによる検索は、必要に応じてオプションのmaskパラメータでも行うことができます。

org

入力フィールド:iporgasnのうち1つを必須とします。 Netblock(netname、description、remarks)またはOrganizationフィールド(org.org、org.name、org.email、org.address)に指定された単語を含むIPアドレスレンジを検索。複数の単語を指定するには:?org[]=term1&org[]=term2&org[]=term3

asn

入力フィールド:iporgasnのいずれかが必要です。AS番号(ASN)でIPアドレスレンジを取得します。

入力パラメータ:任意

outputFormat

応答の出力形式。

使用可能な値: JSON | XML

初期値:JSON

mask

ipパラメータのみオプションです。CIDRで範囲を取得します。

使用可能な値:0 - 128(IPv4では0 - 32)。

初期値:128

limit

返されたレコードの最大カウント数。

使用可能な値:1 - 1000

初期値:100

from

IPアドレスレンジは、返される結果のオフセットとして使用されます。

応答はすべてlimitレコード数(デフォルト:100)に制限されているため、応答のnextパラメータをこのパラメータに入れることで、次のページを取得することができます。たとえば、nextパラメータが「6.0.0.0-13.115.255.255」である場合、次のページを取得するためには、https://ip-netblocks.whoisxmlapi.com/api/v2?apiKey=YOUR_API_KEY&ip=8.8.8.8&limit=5&from=6.0.0.0-13.115.255.255をコールしてください。

パラメータが省略された場合は、最大limitレコード数(デフォルト:100)を取得します。

nextパラメータがnullのの場合、次のページは存在しません。

このようなページネーションは、IPv4、IPv6、ASN APIリクエストでのみ利用可能です。ORGリクエストはサポートしていません。

無料アクセス

ご登録後、上限1,000クエリの無料サブスクリプションプランが自動的に適用されます。

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

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

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