Votre adresse IP:
18.226.88.126
Fournisseur:
...

Information générale

Notre API est crée comme une ressource publique pour la réception de l'information la plus complète sur l'adresse IP de l'utilisateur. Les données sont fournies au format XML ou JSON, en utilisant une connexion HTTP/HTTPS. L'information contenue dans les bases de données se renouvèle quotidiennement et chaque webmaster peut integrer le service avec leurs projets.

Notre API

Pour l'intégration du service avec ses projets, nous vous offrons l'une des API suivantes:

  • service "Geo-IP API";
  • service "Fournisseur-IP API".
  • service "Hébergement API".
  • service "Adresse-MAC API";
  • service "Email API".

Les limites d'utilisation

La limite du nombre de demandes de "Geo-IP API", "Fournisseur-IP API", "Hébergement API", "Adresse-MAC API" ou "Email API" ne constitue plus de 10 demandes provenant de la même adresse IP au cours de la journée.

Le format de données

Les données fournies par notre API contient les champs suivants

country_code — identificateur de pays à 2 caractères sur la norme ISO 3166-1;
country — le nom du pays en anglais;
country_rus — le nom du pays en russe;
country_ua — le nom du pays en ukrainien;
region — le nom du région en anglais;
region_rus — le nom du région en russe;
region_ua — le nom du région en ukrainien;
city — le nom de la localité (ville) en anglais;
city_rus — le nom de la localité (ville) en russe;
city_ua — le nom de la localité (ville) en ukrainien;
latitude — latitude géographique;
longitude — longitude géographique;
name_ripe — le nom officiel du fournisseur dans la base des données Internet Routing Registry (IRR);
name_rus — le nom du fournisseur/marque en russe;
site — le site du fournisseur;
as — le numéro de système autonome du fournisseur;
ip_range_start — valeur numérique (iptolong) de la première adresse IP dans le réseau du fournisseur;
ip_range_end — valeur numérique (iptolong) de la dernière adresse IP dans le réseau du fournisseur;
route — le réseau du fournisseur;
mask — le masque de réseau du fournisseur;.
name_ripe — le nom officiel du fournisseur d'hébergement dans la base des données Internet Routing Registry (IRR);
site — le site du fournisseur d'hébergement;
company — le nom de l'entreprise qui a enregistré le bloc d'adresses MAC;
address — adresse complète de l'entreprise;
country — Identifiant de pays à 2 caractères selon la norme ISO 3166-1;
private — moyennant un supplément, les fournisseurs peuvent cacher leurs données. Dans ce cas, cet indicateur est défini sur true et la société, l'adresse et le pays sont définis sur «privé»;
oui — identifiant unique d'organisation;
block_size — taille de bloc;
date_created — date à laquelle la plage a été attribuée;
date_updated — date de la dernière mise à jour de la plage;
true — adresse e-mail vérifiable existe;
false — adresse e-mail vérifiable n'existe pas;

Des exemples de requêtes à API

IPv4:

IPv6:

Appel API avec vide paramètre "ip" renvoie des informations sur l'adresse IP à partir de laquelle on fait la demande.

IPv4:

Appel API avec vide paramètre "ip" renvoie des informations sur l'adresse IP à partir de laquelle on fait la demande.

Le format de l'adresse MAC pour la vérification peut être l'un des suivants:

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

Des exemples des réponses

<geo_api>
<ip>8.8.8.8</ip>
<country_code>US</country_code>
<country>United states</country>
<country_rus>США</country_rus>
<country_ua>США</country_ua>
<region>California</region>
<region_rus>Калифорния</region_rus>
<region_ua>Каліфорнія</region_ua>
<city>Mountain view</city>
<city_rus>Маунтин-Вью</city_rus>
<city_ua>Маунтін-Вью</city_ua>
<latitude>37.405992</latitude>
<longitude>-122.078515</longitude>
</geo_api>
{
"ip":"8.8.8.8",
"country_code":"US",
"country":"United states",
"country_rus":"\u0421\u0428\u0410\r",
"country_ua":"\u0423\u043a\u0440\u0430\u0457\u043d\u0430",
"region":"California",
"region_rus":"\u041a\u0430\u043b\u0438\u0444\u043e\u0440\u043d\u0438\u044f",
"region_ua":"\u041a\u0438\u0457\u0432\u0441\u044c\u043a\u0430 \u043e\u0431\u043b\u0430\u0441\u0442\u044c",
"city":"Mountain view",
"city_rus":"\u041c\u0430\u0443\u043d\u0442\u0438\u043d-\u0412\u044c\u044e",
"city_ua":"\u0411\u043e\u0440\u0438\u0441\u043f\u0456\u043b\u044c",
"latitude":"37.405992",
"longitude":"-122.078515",
}
<provider_api>
<name_ripe>PJSC "Datagroup"</name_ripe>
<name_rus>ЧАО "Датагруп"</name_rus>
<site>https://www.domtele.com/</site>
<as>21219</as>
<ip_range_start>83951616</ip_range_start>
<ip_range_end>83959807</ip_range_end>
<route>5.1.0.0</route>
<mask>19</mask>
</provider_api>
{
"name_ripe":"PJSC \"Datagroup\"",
"name_rus":"\u0427\u0410\u041e \"\u0414\u0430\u0442\u0430\u0433\u0440\u0443\u043f\"",
"site":"http:\/\/www.domtele.com\/",
"as":"21219",
"ip_range_start":"83951616",
"ip_range_end":"83959807",
"route":"5.1.0.0",
"mask":"19"
}
<hosting_api>
<name_ripe>Google Inc.</name_ripe>
<site>https://www.google.com/</site>
</hosting_api>
{
"name_ripe":"Google Inc."
"site":"https:\/\/www.google.com\/"
}
<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>
{
"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"
}
true / false
{
"exist":true,
"detail":{
"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"]
}
}

Module Python

Nous avons développé un module Python, qui est très facile à installer et à utiliser l'API maintenant.

Install the module from PyPI:

python3 -m pip install 2ip

Retrieve provider information for the IP address 192.0.2.0 as a dict:

>>> from twoip import TwoIP
    >>> twoip = TwoIP(key = None)
    >>> twoip.provider(ip = '192.0.2.0')
    {'ip': '192.0.2.0',
     'ip_range_end': '3221226239',
     'ip_range_start': '3221225984',
     'mask': '24',
     'name_ripe': 'Reserved AS',
     'name_rus': '',
     'route': '192.0.2.0'}

Retrieve geographic information for the IP address 8.8.8.8 as a dict:

>>> from twoip import TwoIP
    >>> twoip = TwoIP(key = None)
    >>> twoip.geo(ip = '8.8.8.8')
    {'city': 'Mountain view',
     'country': 'United states of america',
     'country_code': 'US',
     'country_rus': 'США',
     'country_ua': 'США',
     'ip': '8.8.8.8',
     'latitude': '37.405992',
     'longitude': '-122.078515',
     'region': 'California',
     'region_rus': 'Калифорния',
     'region_ua': 'Каліфорнія'}

More information here: https://pypi.org/project/2ip/

Le coût

10 requêtes par jour sont gratuites.

1000 demandes par jour à notre base de données pendant 30 jours coûtent 10$. Chaque mille suivant + 1$. Par exemple, si vous voulez 5000 demandes par jour, cela vous coûtera 14$ par mois.

Nombre illimité de requêtes — 100$ par mois (mais pas plus d'un million de visites par jour).

Après le paiement, vous recevrez un email avec les instructions et votre "clé API" personnelle. La limite sera liée à cela.

Vous pouvez obtenir des informations plus détaillées ou contactez-nous au [email protected].