2IPのAPI

概要

当サイトのAPIは、ユーザーのIPアドレスに関する最も詳細な情報を取得するための公開リソースとして作成されています。データ形式はXMLまたはJSONで、HTTP/HTTPS接続で提供されます。データベースの情報は毎日更新され、すべてのWebマスターがこのサービスをご自身のプロジェクトに組み込むことができます。

当サイトのサービスをお客様のプロジェクトに組み込むために、以下のいずれかのAPIをご用意しています。

「Geo-IP API」サービス
「Provider-IP API」サービス
「Proxy-IP API」サービス
「Hosting API」サービス
「MAC-address API」サービス
「Email API」サービス

利用制限

Geo-IP API、Provider-IP API、Proxy-IP API、Hosting API、MAC-address API、Email APIの各サービスでは、1つのIPアドレスにつき1日あたり2回まで無料でリクエストできます。

データ形式

当サイトのAPIが提供するデータには、以下のフィールドが含まれます。

「Geo-IP API」サービス：

ip — 確認対象のIPアドレス

country_code — 2文字の国コード

country — 英語の国名

country_rus — ロシア語の国名

country_ua — ウクライナ語の国名

region — 英語の地域名

region_rus — ロシア語の地域名

region_ua — ウクライナ語の地域名

city — 英語の都市名

city_rus — ロシア語の都市名

city_ua — ウクライナ語の都市名

latitude — 緯度

longitude — 経度

「Provider-IP API」サービス：

ip — 確認対象のIPアドレス

name_ripe — インターネットルーティングレジストリ（IRR）データベースに登録されているプロバイダーの正式名称

name_rus — ロシア語のプロバイダー名／ブランド名

site — プロバイダーのWebサイト

as — プロバイダーのAS

ip_range_start — ISPネットワークの最初のIPアドレスの数値（iptolong）

ip_range_end — ISPネットワークの最後のIPアドレスの数値（iptolong）

route — ネットワーク

mask — ネットマスク

「Proxy-IP API」サービス：

ip — 確認対象のIPアドレス

if_this_proxy_ip — IPアドレスがプロキシデータベースに登録されているかどうか：yesまたはno

ip_from — プロキシ範囲の最初のIPアドレスの数値

ip_to — プロキシ範囲の最後のIPアドレスの数値

proxy_type — プロキシの種類

country_code — 2文字の国コード

country_name — 国名

region_name — 地域名

city_name — 都市名

isp — ネットワークのプロバイダーまたは所有者

domain — IPアドレスに関連付けられたドメイン

usage_type — ネットワークの利用タイプ

asn — 自律システム番号

as — 自律システム名

last_seen — 最後に検出されてからの日数

threat — 既知の脅威または望ましくない活動の指標

provider — プロキシデータの提供元

message — プロキシデータベースに登録されていないIPアドレスに関する説明

「Hosting API」サービス：

name_ripe — インターネットルーティングレジストリ（IRR）データベースに登録されているホスティングプロバイダーの正式名称

site — ホスティングプロバイダーのWebサイト

「MAC-address API」サービス：

company — MACアドレスブロックを登録した企業の名称

address — 企業の完全な住所

country — ISO 3166-1規格に基づく2文字の国コード

private — 追加料金を支払うことで、ベンダーは自社のデータを非公開にできます。この場合、このフラグはtrueに設定され、company、address、countryは「private」に設定されます

oui — 組織固有識別子

block_size — ブロックサイズ

date_created — 範囲が割り当てられた日付

date_updated — 範囲が最後に更新された日付

「Email API」サービス：

true — 確認対象のメールアドレスが存在します

false — 確認対象のメールアドレスは存在しません

APIリクエストの例

「Geo-IP API」サービスへのXMLおよびJSONリクエストの例：

IPv4:

IPv6:

パラメーター「ip」を空にしてAPIを呼び出すと、リクエスト送信元のIPアドレスに関する情報が返されます。

XML: https://api.2ip.me/geo.xml?ip=
JSON: https://api.2ip.me/geo.json?ip=

「Provider-IP API」サービスへのXMLおよびJSONリクエストの例：

IPv4:

パラメーター「ip」を空にしてAPIを呼び出すと、リクエスト送信元のIPアドレスに関する情報が返されます。

XML: https://api.2ip.me/provider.xml?ip=
JSON: https://api.2ip.me/provider.json?ip=

「Proxy-IP API」サービスへのXMLおよびJSONリクエストの例：

IPv4:

パラメーター「ip」を空にしてAPIを呼び出すと、リクエスト送信元のIPアドレスに関する情報が返されます。

XML: https://api.2ip.me/proxy.xml?ip=
JSON: https://api.2ip.me/proxy.json?ip=

「Hosting API」サービスへのXMLおよびJSONリクエストの例：

「MAC-address API」サービスへのXMLおよびJSONリクエストの例：

確認するMACアドレスの形式は、以下のいずれかを使用できます。

00:30:48:5a:58:65
00-22-15-75-1C-1E
000a.e475.7469
001201BB4ADD

「Email API」サービスへのXMLおよびJSONリクエストの例：

XML: https://api.2ip.me/[email protected]
JSON: https://api.2ip.me/[email protected]

レスポンスの例

「Geo-IP API」サービスからのXMLレスポンスの例：

<geo_api>

<country_code>FR</country_code>

<country>France</country>

<country_rus>Франция</country_rus>

<country_ua>Франція</country_ua>

<region>Ile-de-france</region>

<region_rus>Иль-де-Франс</region_rus>

<region_ua>Іль-де-Франс</region_ua>

<city>Paris</city>

<city_rus>Париж</city_rus>

<city_ua>Маунтін-Вью</city_ua>

</geo_api>

「Geo-IP API」サービスからのJSONレスポンスの例：

{

"ip":"45.140.147.155",

"country_code":"FR",

"country":"France",

"country_rus":"\u0424\u0440\u0430\u043d\u0446\u0438\u044f",

"country_ua":"\u0424\u0440\u0430\u043d\u0446\u0456\u044f",

"region":"Ile-de-france",

"region_rus":"\u0418\u043b\u044c-\u0434\u0435-\u0424\u0440\u0430\u043d\u0441",

"region_ua":"\u0406\u043b\u044c-\u0434\u0435-\u0424\u0440\u0430\u043d\u0441",

"city":"Paris",

"city_rus":"\u041f\u0430\u0440\u0438\u0436",

"city_ua":"\u041f\u0430\u0440\u0456\u0436",

"latitude":"48.859078",

"longitude":"2.293486",

}

「Provider-IP API」サービスからのXMLレスポンスの例：

<provider_api>

<name_ripe>Baykov Ilya Sergeevich</name_ripe>

<name_ua></name_ua>

<name_rus></name_rus>

<site>http://www.zaoipnet.ru/</site>

<ip_range_start>764187392</ip_range_start>

<ip_range_end>764187647</ip_range_end>

</provider_api>

「Provider-IP API」サービスからのJSONレスポンスの例：

{

"ip":"45.140.147.155",

"name_ripe":"Baykov Ilya Sergeevich",

"name_ua":"",

"name_rus":"",

"site":"http:\/\/www.zaoipnet.ru\/",

"as":"41745",

"ip_range_start":"764187392",

"ip_range_end":"764187647",

"route":"",

"mask":"24"

}

「Proxy-IP API」サービスからのXMLレスポンスの例：

<proxy_api>

<if_this_proxy_ip>yes</if_this_proxy_ip>

<ip_from>764187547</ip_from>

<ip_to>764187547</ip_to>

<proxy_type>PUB</proxy_type>

<country_code>FR</country_code>

<country_name>France</country_name>

<region_name>Ile-de-France</region_name>

<city_name>Paris</city_name>

<isp>Baykov Ilya Sergeevich</isp>

<domain>hip-hosting.com</domain>

<usage_type>DCH</usage_type>

<as>Baykov Ilya Sergeevich</as>

<last_seen>30</last_seen>

<threat>SPAM/SCANNER/BOTNET</threat>

</proxy_api>

「Proxy-IP API」サービスからのJSONレスポンスの例：

{

"ip":"45.140.147.155",

"if_this_proxy_ip":"yes",

"ip_from":"764187547",

"ip_to":"764187547",

"proxy_type":"PUB",

"country_code":"FR",

"country_name":"France",

"region_name":"Ile-de-France",

"city_name":"Paris",

"isp":"Baykov Ilya Sergeevich",

"domain":"hip-hosting.com",

"usage_type":"DCH",

"asn":"41745",

"as":"Baykov Ilya Sergeevich",

"last_seen":"30",

"threat":"SPAM\/SCANNER\/BOTNET",

"provider":"-"

}

「Hosting API」サービスからのXMLレスポンスの例：

<hosting_api>

<name_ripe>Google Inc.</name_ripe>

<site>https://www.google.com/</site>

</hosting_api>

「Hosting API」サービスからのJSONレスポンスの例：

{

"name_ripe":"Google Inc."

"site":"https:\/\/www.google.com\/"

}

「MAC-address API」サービスからのXMLレスポンスの例：

<company>Super Micro Computer, Inc</company>

<address>2051 Junction Avenue San Jose CA 95131 US</address>

<block_size>MA-L</block_size>

<date_created>2000-11-09</date_created>

<date_updated>2015-09-27</date_updated>

</macVendor>

「MAC-address API」サービスからのJSONレスポンスの例：

{

"company":"Super Micro Computer, Inc",

"address":"2051 Junction Avenue San Jose CA 95131 US",

"country":"US",

"private":"0",

"oui":"00:30:48",

"block_size":"MA-L",

"date_created":"2000-11-09",

"date_updated":"2015-09-27"

}

「Email API」サービスからのXMLレスポンスの例：

true / false

「Email API」サービスからのJSONレスポンスの例：

{

"exist":true,

"detail":{

"[email protected]":true,

"domains":{

"google.com":{

"users":["admin"],

"mxs":{

"aspmx.l.google.com":10,

"alt1.aspmx.l.google.com":20,

"alt2.aspmx.l.google.com":30,

"alt3.aspmx.l.google.com":40,

"alt4.aspmx.l.google.com":50,

"google.com":0

}

"log":[

"[2019-02-13T19:26:56.533234+0000] Connecting to aspmx.l.google.com:25",

"[2019-02-13T19:26:56.566308+0000] Connected to aspmx.l.google.com:25 successfully",

"[2019-02-13T19:26:56.600374+0000] <<<recv: 220 mx.google.com ESMTP u13-v6si69438lju.221 - gsmtp\r\n",

"[2019-02-13T19:26:56.600473+0000] send>>>: EHLO 2ip.ua",

"[2019-02-13T19:26:56.637390+0000] <<<recv: 250-mx.google.com at your service, [77.123.139.187]\r\n",

"[2019-02-13T19:26:56.637419+0000] <<<recv: 250-SIZE 157286400\r\n",

"[2019-02-13T19:26:56.637426+0000] <<<recv: 250-8BITMIME\r\n",

"[2019-02-13T19:26:56.637430+0000] <<<recv: 250-STARTTLS\r\n",

"[2019-02-13T19:26:56.637434+0000] <<<recv: 250-ENHANCEDSTATUSCODES\r\n",

"[2019-02-13T19:26:56.637438+0000] <<<recv: 250-PIPELINING\r\n",

"[2019-02-13T19:26:56.637442+0000] <<<recv: 250-CHUNKING\r\n",

"[2019-02-13T19:26:56.637445+0000] <<<recv: 250 SMTPUTF8\r\n",

"[2019-02-13T19:26:56.637457+0000] send>>>: MAIL FROM:<[email protected]>",

"[2019-02-13T19:26:56.670259+0000] <<<recv: 250 2.1.0 OK u13-v6si69438lju.221 - gsmtp\r\n",

"[2019-02-13T19:26:56.670292+0000] send>>>: NOOP",

"[2019-02-13T19:26:56.703219+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",

"[2019-02-13T19:26:56.703253+0000] send>>>: NOOP",

"[2019-02-13T19:26:56.736009+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",

"[2019-02-13T19:26:56.736052+0000] send>>>: RCPT TO:<[email protected]>",

"[2019-02-13T19:26:56.985345+0000] <<<recv: 250 2.1.5 OK u13-v6si69438lju.221 - gsmtp\r\n",

"[2019-02-13T19:26:56.985377+0000] send>>>: NOOP",

"[2019-02-13T19:26:57.018204+0000] <<<recv: 250 2.0.0 OK u13-v6si69438lju.221 - gsmtp\r\n",

"[2019-02-13T19:26:57.018236+0000] send>>>: RSET",

"[2019-02-13T19:26:57.051533+0000] <<<recv: 250 2.1.5 Flushed u13-v6si69438lju.221 - gsmtp\r\n",

"[2019-02-13T19:26:57.051576+0000] send>>>: QUIT",

"[2019-02-13T19:26:57.084687+0000] <<<recv: 221 2.0.0 closing connection u13-v6si69438lju.221 - gsmtp\r\n",

"[2019-02-13T19:26:57.084761+0000] Closing socket to aspmx.l.google.com:25"]

}

料金

対象となる各APIでは、1つのIPアドレスにつき1日あたり2回まで無料でリクエストできます。

当サイトのデータベースへの1日あたり1000リクエストを30日間ご利用いただく料金は10$です。以降1000リクエストごとに+1$となります。たとえば、1日あたり5000リクエストをご希望の場合、料金は月額14$です。

リクエスト数無制限 — 月額100$（ただし1日あたり100万回の呼び出しまで）。

お支払い後、手順と個人用の「APIキー」が記載されたメールが届きます。利用上限はこのキーに紐づけられます。

詳細情報は、リクエストを送信していただくか、 [email protected]までお問い合わせください。