本文へスキップ
ipaddress.tr

API

ウェブサイトと同じデータをJSONまたはプレーンテキストで提供します。キーもアカウントも不要で、妥当な利用制限があります。

curl https://ipaddress.tr/api/v1/my-ip?format=text

エンドポイント

パス説明データレート制限
GET/api/v1/my-ip試す: /api/v1/my-ipあなたのIPアドレス（?format=textでプレーンテキストも可）。自社データセット120 · 240/分
GET/api/v1/ip/{address}試す: /api/v1/ip/144.122.145.153アドレスのネットワーク、ルーティング、レジストリ、位置データ。自社データセット30 · 30/分
GET/api/v1/ip/geolocation?ip=試す: /api/v1/ip/geolocation?ip=177.224.0.1アドレスの推定位置のみ（DB-IP Lite）。常に推定と明記します。自社データセット30 · 30/分
GET/api/v1/ip/asn?ip=試す: /api/v1/ip/asn?ip=2001:1208::1アドレスの発信元ASと広報プレフィックス、および含まれるレジストリの割り当て。自社データセット30 · 30/分
GET/api/v1/ip/reverse?ip=試す: /api/v1/ip/reverse?ip=8.8.8.8公開アドレスのPTRレコードをライブで、正引き確認付きで返します。ライブ照会40 · 60/分
GET/api/v1/ip/blacklist?ip=試す: /api/v1/ip/blacklist?ip=8.8.8.8公開アドレスのライブDNSBL結果（SpamCop、PSBL、DroneBL、s5h.net）とTor出口フラグ。ライブ照会40 · 60/分
POST/api/v1/bulkcurl --data-binary $'1.1.1.1\n9.9.9.9' https://ipaddress.tr/api/v1/bulk一度に最大 100 件(JSON {"addresses": […]} または 1 行に 1 件)。当サイト独自のデータセットだけで回答し、何も保存しません。自社データセット6 · 3/分
GET/api/v1/asn/{asn}試す: /api/v1/asn/AS8151自律システムの保有者、レジストリ、広報プレフィックス。自社データセット30 · 30/分
GET/api/v1/network/{cidr}試す: /api/v1/network/144.122.0.0/16CIDR表記のネットワーク：サイズ、範囲、特殊用途か、広報者（RPKI付き）、レジストリのデリゲーション、位置の推定。自社データセット30 · 30/分
GET/api/v1/network/ipv4?cidr=試す: /api/v1/network/ipv4?cidr=192.168.1.37/24IPv4またはIPv6ネットワークのサブネット計算：ネットワーク、ブロードキャスト、マスク、利用可能範囲、個数。自社データセット120 · 240/分
GET/api/v1/network/ipv6?cidr=試す: /api/v1/network/ipv6?cidr=2001:db8::/48IPv4またはIPv6ネットワークのサブネット計算：ネットワーク、ブロードキャスト、マスク、利用可能範囲、個数。自社データセット120 · 240/分
GET/api/v1/country/{cc}試す: /api/v1/country/MXある国に登録されたアドレス空間と AS 番号、その国のネットワークが広告するもの、RPKI のカバー率、上位ネットワーク（TR は県別の推定も）。自社データセット30 · 30/分
GET/api/v1/dns/{domain}?type=A,MX試す: /api/v1/dns/metu.edu.tr?type=A,MXドメインの最新DNSレコード。ライブ照会40 · 60/分
GET/api/v1/dns/propagation?name=&type=試す: /api/v1/dns/propagation?name=metu.edu.tr&type=A同じDNSの問い合わせを複数のパブリックリゾルバーに送り、各回答と一致しているかを返します。ライブ照会40 · 60/分
GET/api/v1/rdap/{query}試す: /api/v1/rdap/AS8151担当RDAPサーバーからの登録データ。ライブ照会10 · 6/分
GET/api/v1/health試す: /api/v1/healthサービスの稼働状況。自社データセット120 · 240/分
GET/api/v1/data-status試す: /api/v1/data-status各データセットの鮮度とサイズ。自社データセット120 · 240/分

/api/v1 外のテキスト用ショートカット：/raw はアドレス、/json は /my-ip と同じオブジェクト、/country は推定国コードを返します。

パス形式の各エンドポイントにはクエリ形式もあります：/ip/lookup?ip=、/asn/lookup?asn=、/dns/lookup?name=、/network/cidr?cidr=。各レスポンスに X-Request-Id ヘッダーが付きます。

curl ipaddress.tr/rawcurl ipaddress.tr/jsoncurl ipaddress.tr/country

レート制限

リクエストはクライアントアドレスごとにトークンバケットで制限されます。上限に達するとAPIはRetry-Afterヘッダー付きで429を返します。カウントはメモリ上で毎日変わるハッシュキーを使い、アドレスは保存しません。

エラー

エラーはHTTPステータスコードと {"error": {"code": "…", "message": "…"}} 形式のJSON本文で返します。

バージョン管理

/api/v1/ 以下のパスはレスポンス構造を維持します。フィールドの追加はありますが、v1内で既存フィールドの削除や名称変更はしません。

クレジット表記

位置データはDB-IP（CC BY 4.0）によるものです。表示する場合はライセンスに従いDB-IPを表記してください。