API de recherche IPv4
Pays, région, ville, coordonnées approximatives, fuseau horaire, le réseau et l'opérateur qui le gère, indicateurs de centre de données et de proxy, et un bloc de menaces qui indique si l'adresse a été signalée pour des abus ou des attaques, et avec quelle gravité. Omettez le paramètre ip et vous obtenez l'adresse de l'appelant, ce qui est le cas le plus courant pour les sites web.
Exemple
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4?ip=8.8.8.8"
# The caller's own address
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv4"La géolocalisation d'une adresse IP au niveau de la ville est une estimation et le restera toujours : l'adresse appartient à un réseau, pas à une personne. Le pays est correct pour bien plus de 99 % des adresses. La ville est la plus fiable pour les fournisseurs d'accès grand public et la moins fiable pour les opérateurs mobiles et les centres de données, c'est pourquoi ces derniers sont signalés.
{
"status": "ok",
"ip": "1.0.164.165",
"version": 4,
"found": true,
"prefix": "1.0.164.0/24",
"country": "Thailand",
"country_code": "TH",
"continent": "Asia",
"continent_code": "AS",
"region": "Krung Thep Maha Nakhon",
"region_code": null,
"city": "Bangkok",
"postcode": "10200",
"lat": 13.749976,
"lon": 100.516819,
"timezone": "Asia/Bangkok",
"utc_offset": "+07:00",
"utc_offset_seconds": 25200,
"is_eu": false,
"asn": 23969,
"as_name": "TOT Public Company Limited",
"org": "TOT Public Company Limited",
"usage_type": "Eyeball",
"registry": "apnic",
"allocated": "2008-10-22",
"tags": ["dsl"],
"is_anycast": false,
"is_satellite": false,
"is_datacenter": false,
"is_proxy": false,
"is_vpn_provider": false,
"is_tor": false,
"is_private": false,
"abuse_email": "abuse@totisp.net",
"threat": {
"listed": true,
"score": 90,
"source_count": 2,
"categories": ["abuse", "attacker"],
"is_tor": false,
"is_tor_exit": false,
"is_bogon": false,
"listings": [
{ "category": "abuse", "confidence": 100, "recency_days": 1 },
{ "category": "attacker", "confidence": null, "recency_days": null }
]
},
"updated_at": "2026-09-18 06:53:39"
}Ce que vous recevez
| Champ | Signification |
|---|---|
country, country_code | Nom du pays et code ISO 3166-1 alpha-2. |
region, region_code | État, province ou équivalent, avec son code ISO 3166-2 s'il en existe un. |
city, postcode | Meilleure estimation de la ville et du code postal. Absent si inconnu. |
lat, lon | Coordonnées de la ville ou, à défaut, du centre de la région ou du pays. |
timezone | Nom IANA, déduit de la localisation. |
asn, org | Le numéro de système autonome et l'organisation qui annonce le préfixe. |
is_datacenter | L'adresse appartient à une plage d'hébergement ou de cloud. Considérez la ville comme peu fiable et envisagez que le trafic puisse être automatisé. |
is_proxy, is_tor, is_vpn_provider | Preuves, adresse par adresse, d'un relais Tor ou d'une inscription sur une liste de proxys ; et, séparément, si l'opérateur vend des services VPN. |
usage_type, tags, registry, allocated, abuse_email | Le type d'opérateur qui gère le réseau, ses étiquettes d'opérateur, le registre qui l'a attribué et quand, et son contact pour les abus. |
threat | Bloc de réputation : listée ou non, un score de 0 à 100, le nombre de signalements indépendants qui listent l'adresse et dans quelles catégories, les indicateurs Tor et bogon, et chaque inscription avec sa confiance et son ancienneté. Actualisé chaque jour. |
Où elle est utilisée
Localiser une première visite
Choisissez un pays, une devise, une langue et des unités par défaut avant que le visiteur n'ait saisi quoi que ce soit. Transmettez l'adresse du visiteur dans ip depuis votre serveur.
Signaux de fraude et d'abus
Comparez le pays de l'IP avec le pays de facturation. Traitez is_proxy et is_datacenter comme des signaux, pas comme des verdicts.
Des statistiques sans cookies
Agrégez les visites par pays et par région côté serveur à partir des journaux d'accès, sans aucun suivi côté client.
Prix et limites
Un appel correspond à une requête ; chaque adresse d'un lot compte pour une. Chaque clé dispose de 2 500 requêtes gratuites par jour ; au-delà, 0,0001 € par requête sur le crédit prépayé, ou rien avec une clé Unlimited (50 € par mois). Tarifs. Vous migrez depuis ip-api, ipinfo ou ipstack ? Ces formats sont disponibles sous forme d'hôtes compatibles (drop-in). Pour les adresses IPv6, consultez l'API de recherche IPv6.