2IP API
Allgemeine Informationen
Unsere API wurde als öffentliche Ressource geschaffen, um möglichst vollständige Informationen über die IP-Adresse eines Nutzers abzurufen. Die Daten werden im XML- oder JSON-Format über eine HTTP/HTTPS-Verbindung bereitgestellt. Die Informationen in den Datenbanken werden täglich aktualisiert, und jeder Webmaster kann diesen Dienst in seine eigenen Projekte integrieren.
Unsere API
Für die Integration unseres Dienstes in Ihre Projekte bieten wir Ihnen eine der folgenden APIs an:
- Dienst „Geo-IP API“;
- Dienst „Provider-IP API“.
- Dienst „Proxy-IP API“.
- Dienst „Hosting API“;
- Dienst „MAC-address API“;
- Dienst „Email API“.
Nutzungsbeschränkungen
Jeder der Dienste Geo-IP API, Provider-IP API, Proxy-IP API, Hosting API, MAC-address API und Email API erlaubt höchstens 2 kostenlose Anfragen pro IP-Adresse und Tag.
Datenformat
Die von unserer API bereitgestellten Daten enthalten die folgenden Felder.
Dienst „Geo-IP API“:
ip — geprüfte IP-Adresse;
country_code — zweistelliger Ländercode;
country — Name des Landes auf Englisch;
country_rus — Name des Landes auf Russisch;
country_ua — Name des Landes auf Ukrainisch;
region — Name der Region auf Englisch;
region_rus — Name der Region auf Russisch;
region_ua — Name der Region auf Ukrainisch;
city — Name der Stadt auf Englisch;
city_rus — Name der Stadt auf Russisch;
city_ua — Name der Stadt auf Ukrainisch;
latitude — Breitengrad;
longitude — Längengrad;
Dienst „Provider-IP API“:
ip — geprüfte IP-Adresse;
name_ripe — offizieller Name des Anbieters in der Datenbank des Internet Routing Registry (IRR);
name_rus — Name/Marke des Anbieters auf Russisch;
site — Website des Anbieters;
as — AS des Anbieters;
ip_range_start — numerischer Wert (iptolong) der ersten IP-Adresse des Netzwerks des Internetanbieters;
ip_range_end — numerischer Wert (iptolong) der letzten IP-Adresse des Netzwerks des Internetanbieters;
route — Netzwerk;
mask — Netzmaske.
Dienst „Proxy-IP API“:
ip — geprüfte IP-Adresse;
if_this_proxy_ip — ob die IP-Adresse in der Proxy-Datenbank aufgeführt ist: yes oder no;
ip_from — numerischer Wert der ersten IP-Adresse im Proxy-Bereich;
ip_to — numerischer Wert der letzten IP-Adresse im Proxy-Bereich;
proxy_type — Proxy-Typ;
country_code — zweistelliger Ländercode;
country_name — Name des Landes;
region_name — Name der Region;
city_name — Name der Stadt;
isp — Netzwerkanbieter oder -inhaber;
domain — mit der IP-Adresse verknüpfte Domain;
usage_type — Art der Netzwerknutzung;
asn — Nummer des autonomen Systems;
as — Name des autonomen Systems;
last_seen — Anzahl der Tage seit der letzten Erkennung;
threat — bekannte Bedrohungen oder Anzeichen unerwünschter Aktivitäten;
provider — Anbieter der Proxy-Daten;
message — Erläuterung für eine IP-Adresse, die nicht in der Proxy-Datenbank aufgeführt ist.
Dienst „Hosting API“:
name_ripe — offizieller Name des Hosting-Anbieters in der Datenbank des Internet Routing Registry (IRR);
site — Website des Hosting-Anbieters;
Dienst „MAC-address API“:
company — Name des Unternehmens, das den MAC-Adressblock registriert hat;
address — vollständige Anschrift des Unternehmens;
country — zweistelliger Ländercode gemäß der Norm ISO 3166-1;
private — gegen eine zusätzliche Gebühr können Hersteller ihre Daten verbergen. In diesem Fall wird dieses Flag auf true gesetzt, und company, address und country erhalten den Wert «private»;
oui — eindeutige Organisationskennung;
block_size — Blockgröße;
date_created — Datum, an dem der Bereich zugewiesen wurde;
date_updated — Datum der letzten Aktualisierung des Bereichs;
Dienst „Email API“:
true — die geprüfte E-Mail-Adresse existiert;
false — die geprüfte E-Mail-Adresse existiert nicht;
Beispiele für API-Anfragen
Beispiel für XML- und JSON-Anfragen an den Dienst „Geo-IP API“:
IPv4:
- XML: https://api.2ip.me/geo.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/geo.json?ip=45.140.147.155
IPv6:
- XML: https://api.2ip.me/geo.xml?ip=2001:4860:4860::8844
- JSON: https://api.2ip.me/geo.json?ip=2001:4860:4860::8844
Ein API-Aufruf mit leerem Parameter „ip“ liefert Informationen über die IP-Adresse, von der die Anfrage stammt.
Beispiel für XML- und JSON-Anfragen an den Dienst „Provider-IP API“:
IPv4:
- XML: https://api.2ip.me/provider.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/provider.json?ip=45.140.147.155
Ein API-Aufruf mit leerem Parameter „ip“ liefert Informationen über die IP-Adresse, von der die Anfrage stammt.
Beispiel für XML- und JSON-Anfragen an den Dienst „Proxy-IP API“:
IPv4:
- XML: https://api.2ip.me/proxy.xml?ip=45.140.147.155
- JSON: https://api.2ip.me/proxy.json?ip=45.140.147.155
Ein API-Aufruf mit leerem Parameter „ip“ liefert Informationen über die IP-Adresse, von der die Anfrage stammt.
Beispiel für XML- und JSON-Anfragen an den Dienst „Hosting API“:
Beispiel für XML- und JSON-Anfragen an den Dienst „MAC-address API“:
- XML: https://api.2ip.me/mac.xml?mac=00:30:48:5a:58:65
- JSON: https://api.2ip.me/mac.json?mac=00:30:48:5a:58:65
Die zu prüfende MAC-Adresse kann in einem der folgenden Formate angegeben werden:
- 00:30:48:5a:58:65
- 00-22-15-75-1C-1E
- 000a.e475.7469
- 001201BB4ADD
Beispiel für XML- und JSON-Anfragen an den Dienst „Email API“:
Antwortbeispiele
Beispiel für eine XML-Antwort des Dienstes „Geo-IP API“:
<geo_api>
<ip>45.140.147.155</ip>
<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>
<latitude>48.859078</latitude>
<longitude>2.293486</longitude>
</geo_api>
Beispiel für eine JSON-Antwort des Dienstes „Geo-IP API“:
{
"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",
}
Beispiel für eine XML-Antwort des Dienstes „Provider-IP API“:
<provider_api>
<ip>45.140.147.155</ip>
<name_ripe>Baykov Ilya Sergeevich</name_ripe>
<name_ua></name_ua>
<name_rus></name_rus>
<site>http://www.zaoipnet.ru/</site>
<as>41745</as>
<ip_range_start>764187392</ip_range_start>
<ip_range_end>764187647</ip_range_end>
<route></route>
<mask>24</mask>
</provider_api>
Beispiel für eine JSON-Antwort des Dienstes „Provider-IP API“:
{
"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"
}
Beispiel für eine XML-Antwort des Dienstes „Proxy-IP API“:
<proxy_api>
<ip>45.140.147.155</ip>
<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>
<asn>41745</asn>
<as>Baykov Ilya Sergeevich</as>
<last_seen>30</last_seen>
<threat>SPAM/SCANNER/BOTNET</threat>
<provider>-</provider>
</proxy_api>
Beispiel für eine JSON-Antwort des Dienstes „Proxy-IP API“:
{
"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":"-"
}
Beispiel für eine XML-Antwort des Dienstes „Hosting API“:
<hosting_api>
<name_ripe>Google Inc.</name_ripe>
<site>https://www.google.com/</site>
</hosting_api>
Beispiel für eine JSON-Antwort des Dienstes „Hosting API“:
{
"name_ripe":"Google Inc."
"site":"https:\/\/www.google.com\/"
}
Beispiel für eine XML-Antwort des Dienstes „MAC-address API“:
<macVendor>
<company>Super Micro Computer, Inc</company>
<address>2051 Junction Avenue San Jose CA 95131 US</address>
<country>US</country>
<private>0</private>
<oui>00:30:48</oui>
<block_size>MA-L</block_size>
<date_created>2000-11-09</date_created>
<date_updated>2015-09-27</date_updated>
</macVendor>
Beispiel für eine JSON-Antwort des Dienstes „MAC-address API“:
{
"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"
}
Beispiel für eine XML-Antwort des Dienstes „Email API“:
true / false
Beispiel für eine JSON-Antwort des Dienstes „Email API“:
{
"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"]
}
}
Preis
Jede betreffende API erlaubt 2 kostenlose Anfragen pro IP-Adresse und Tag.
1000 Anfragen pro Tag an unsere Datenbank für 30 Tage kosten 10$. Jedes weitere Tausend kostet + 1$. Wenn Sie beispielsweise 5000 Anfragen pro Tag benötigen, kostet dies 14$ pro Monat.
Unbegrenzte Anzahl von Anfragen — 100$ pro Monat (jedoch nicht mehr als 1 Million Aufrufe pro Tag).
Nach der Zahlung erhalten Sie eine E-Mail mit einer Anleitung und Ihrem persönlichen „API key“. Das Limit wird an diesen Schlüssel gebunden.
Ausführlichere Informationen erhalten Sie, indem Sie uns eine Anfrage senden, oder kontaktieren Sie uns unter [email protected].