Documentation

API lookup

L’endpoint /api/lookup retourne une réponse JSON avec l’IP analysée, une localisation approximative, l’ASN, le fournisseur, des signaux VPN/proxy et, si demandé, une vérification blacklist.

Exemples d’appel

GET /api/lookup
GET /api/lookup?ip=8.8.8.8
GET /api/lookup?ip=1.1.1.1&blacklist=1

Paramètres

• ip optionnel : IPv4 ou IPv6 à analyser.
• Sans ip, l’API utilise l’IP du visiteur lorsque les headers d’infrastructure nécessaires sont disponibles.
• blacklist=1 ou blacklist=true déclenche la vérification blacklist avec AbuseIPDB, qui analyse un score d'abus et des signalements.
• Sans blacklist=1 ou blacklist=true, AbuseIPDB n’est pas appelé.

Exemple de réponse JSON

{
  "ip": "8.8.8.8",
  "source": "lookup",
  "geo": {
    "country": "United States",
    "countryCode": "US",
    "city": "Mountain View"
  },
  "network": {
    "asn": 15169,
    "organization": "Google LLC"
  },
  "privacy": {
    "vpn": false,
    "proxy": false,
    "tor": false,
    "riskScore": 0
  },
  "reputation": {
    "level": "faible",
    "blacklisted": "unknown"
  },
  "blacklist": {
    "checked": false,
    "source": null,
    "abuseConfidenceScore": null
  }
}

Méthodologie et limites

La géolocalisation IP est approximative. Elle peut indiquer un pays, une région, une ville, un opérateur ou un datacenter sans correspondre à une adresse exacte. L’ASN et le fournisseur proviennent de bases réseau. Les signaux VPN/proxy et les niveaux de risque sont des estimations et peuvent produire des faux positifs ou des faux négatifs.

La vérification blacklist facultative utilise AbuseIPDB pour analyser les signalements et le score d'abus d'une adresse IP. Elle ne constitue pas une interrogation multi-RBL ou DNSBL : un résultat sans signalement AbuseIPDB ne couvre pas toutes les blacklists et reste indicatif. AbuseIPDB n'est pas appelé sans blacklist=1 ou blacklist=true. La disponibilité de l'API, les quotas et les erreurs réseau peuvent influencer la réponse. L'usage abusif de l'API, notamment l'automatisation excessive ou la collecte non autorisée, est interdit.

Codes d’erreur

• 400 : format IP invalide.
• 405 : méthode non supportée.
• 502 : fournisseur externe indisponible pour une IP demandée.

Pages utiles

Consultez aussi la politique de confidentialité, les conditions d’utilisation et la page de contact.