API

Documentation API

FckMyIP met à disposition une API REST publique et gratuite pour obtenir des données de géolocalisation IP. Aucune authentification requise. Les réponses sont au format JSON.

URL de base

Base URL https://fckmyip.com

Tous les endpoints retournent du JSON avec Content-Type: application/json. HTTPS obligatoire.

Endpoints dual-stack (IPv4 / IPv6)

Pour détecter de manière fiable vos adresses IPv4 et IPv6, utilisez les sous-domaines dual-stack dédiés. Chaque sous-domaine résout exclusivement via un seul protocole, garantissant le bon type d'adresse en retour.

GET https://v4.fckmyip.com/api/ip
GET https://v6.fckmyip.com/api/ip

v4.fckmyip.com ne possède que des enregistrements A (IPv4), et v6.fckmyip.com uniquement des enregistrements AAAA (IPv6). Si votre réseau ne supporte pas un protocole donné, la requête correspondante échouera.

Requête

IPv4

cURL 
curl https://v4.fckmyip.com/api/ip

IPv6

cURL 
curl https://v6.fckmyip.com/api/ip

Détection automatique de votre IP

Retourne les données de géolocalisation de l'adresse IP de l'appelant. L'IP est détectée automatiquement à partir de la requête.

GET /api/ip

Requête

Aucun paramètre requis. L'API détecte votre IP publique automatiquement.

cURL 
curl https://fckmyip.com/api/ip

Réponse

200 OK 
{
  "ip": "203.0.113.42",
  "version": "IPv4",
  "city": "Paris",
  "region": "Île-de-France",
  "country": "France",
  "countryCode": "FR",
  "continentCode": "EU",
  "latitude": 48.8566,
  "longitude": 2.3522,
  "timeZone": "Europe/Paris",
  "isp": "Orange S.A.",
  "asn": 3215,
  "isEu": true
}

Rechercher une IP spécifique

Retourne les données de géolocalisation pour une adresse IPv4 ou IPv6 donnée.

GET /api/ip/{address}

Paramètres

Nom Type Description
address string Adresse IPv4 ou IPv6 à rechercher

Requête

IPv4

cURL 
curl https://fckmyip.com/api/ip/8.8.8.8

IPv6

cURL 
curl https://fckmyip.com/api/ip/2001:4860:4860::8888

Réponse

200 OK 
{
  "ip": "8.8.8.8",
  "version": "IPv4",
  "city": "Mountain View",
  "region": "California",
  "country": "United States",
  "countryCode": "US",
  "continentCode": "NA",
  "latitude": 37.386,
  "longitude": -122.0838,
  "timeZone": "America/Los_Angeles",
  "isp": "Google LLC",
  "asn": 15169,
  "isEu": false
}

Champs de la réponse

Champ Type Description
ipstringL'adresse IP interrogée
versionstring"IPv4" ou "IPv6"
citystring?Nom de la ville (peut être null)
regionstring?Région ou état (peut être null)
countrystring?Nom du pays (peut être null)
countryCodestring?Code pays ISO 3166-1 alpha-2
continentCodestring?Code continent à deux lettres (EU, NA, AS...)
latitudenumber?Latitude approximative
longitudenumber?Longitude approximative
timeZonestring?Identifiant de fuseau horaire IANA
ispstring?Nom du fournisseur d'accès Internet
asnnumber?Numéro de système autonome
isEubooleanIndique si le pays est dans l'Union Européenne

Réponses d'erreur

Les erreurs sont retournées en JSON avec un champ "error" décrivant le problème.

Statut Condition Corps de la réponse
400 L'adresse IP n'a pas pu être détectée {"error": "Unable to detect IP address"}
404 IP non trouvée dans la base ou format invalide {"error": "IP not found or invalid"}

Exemples de code

JavaScript (fetch)

JS 
const response = await fetch("https://fckmyip.com/api/ip");
const data = await response.json();
console.log(`${data.ip} — ${data.city}, ${data.country}`);

Python (requests)

Python 
import requests

data = requests.get("https://fckmyip.com/api/ip").json()
print(f"{data['ip']} — {data['city']}, {data['country']}")

C# (HttpClient)

C# 
using var http = new HttpClient();
var json = await http.GetStringAsync("https://fckmyip.com/api/ip/8.8.8.8");
Console.WriteLine(json);

PowerShell

PS 
Invoke-RestMethod https://fckmyip.com/api/ip | Format-List

Lien de recherche directe

Vous pouvez créer un lien direct vers un résultat de recherche sur la page d'accueil FckMyIP en passant une adresse IP en paramètre. La page se charge et lance automatiquement la recherche pour l'adresse donnée.

GET /?ip={address}

Requête

URL 
https://fckmyip.com/?ip=8.8.8.8

Cela ouvre la vue carte interactive avec le résultat de géolocalisation affiché. Utile pour partager un résultat ou intégrer un lien dans une documentation.

Limites & utilisation raisonnable

Cette API est gratuite et ne nécessite aucune clé. Nous vous demandons de l'utiliser de manière responsable : évitez les requêtes automatisées en masse et le polling excessif. Un usage abusif peut entraîner la limitation ou le blocage de votre IP sans préavis. Pour un accès à fort volume, contactez-nous à contact@cognitys.com.