Formuler des demandes

Obligatoire. Récupérez votre clé API personnelle sur la page « Mes produits ».

Obligatoire. L'adresse IPv4 à classer. Spécifiée sous la forme d'un segment de chemin de l'URL de la requête, par exemple /api/v1/ip/185.220.101.1.

L'adresse IPv4 interrogée, renvoyée.

Chaîne de caractères ou null. La plage CIDR à laquelle appartient l'adresse IP, lorsqu'elle est connue.

String. Type de détection de l'adresse IP.

Valeurs autorisées : vpn, corporate_vpn, proxy, hosting, cdn, tor, relay, residential_proxy, residential_proxy_likely, residential_proxy_mobile, datacenter_proxy, mobile_proxy, suspected_vpn, suspected_proxy, unknown.

String ou valeur nulle. Fournisseur associé à l'adresse IP (par exemple, une marque de VPN, un réseau de proxys résidentiels, un hébergeur). Valeur nulle lorsqu'aucune attribution n'est disponible.

Nombre à virgule flottante compris entre [0, 1]. Niveau de confiance calibré dans la classification. Des valeurs plus élevées indiquent des preuves plus solides.

String. Méthode de détection à l'origine de l'enregistrement (par exemple : mslm, port_scan, proxy_enum, netflow_analysis, asn_classification).

String. Identique à la source (champ hérité, conservé pour des raisons de compatibilité ascendante).

Chaîne de caractères (ISO-8601) ou null. Date à laquelle l'adresse IP a été observée pour la première fois.

Chaîne de caractères (ISO-8601) ou null. Date et heure de la dernière détection de l'adresse IP.

Nombre entier. Nombre total d'observations de l'adresse IP (hits).

Valeur flottante ou nulle. Persistance : pourcentage de jours, au sein de la fenêtre d'observation glissante de 90 jours, au cours desquels l'adresse IP a été identifiée comme un point de sortie actif de proxy ou de VPN (nombre de jours d'observation distincts ÷ 90 × 100).

High (>50) indicates a consistently active exit; low (<5) indicates sporadic or one-shot activity. Null when the result comes from a network-range detection with no per-IP observation history.

Nombre entier. Nombre de réseaux proxy / VPN distincts par lesquels l'adresse IP a été observée comme point de sortie. Une valeur égale ou supérieure à 2 indique que l'adresse IP est partagée ou revendue sur plusieurs réseaux commerciaux — ce qui constitue un signal fort indiquant l'utilisation d'un proxy. La valeur 0 signifie qu'il n'y a pas d'historique d'énumération par adresse IP (détection au niveau de la plage uniquement).

Valeur flottante comprise entre [0, 1,5]. Score composite de force des preuves : facteur de récence × cohérence × bonus « multi-fournisseurs ». Les valeurs supérieures à 1,0 indiquent des IP « multi-fournisseurs » actives quotidiennement ; 0,0 signifie qu’aucune observation n’a été relevée au niveau du point. Pour obtenir un score normalisé compris entre 0 et 1, utilisez min(confidence_decay, 1,0).

Chaîne de caractères. Compartiment indiquant la date de la dernière consultation, dérivé de « last_seen », ce qui permet de filtrer sans avoir à effectuer de calculs de date.

Valeurs autorisées : actuelle (observée au cours de la dernière journée), récente (semaine dernière), périmée (au cours des 90 derniers jours), figée (il y a plus de 90 jours, ou jamais observée).

Boolean. True if the classification is in {vpn, vpn_concentrator, corporate_vpn, commercial_vpn, vpn_hosting} (confirmed VPN endpoints). Does not include tor, relay, suspected_vpn, or vpn_suspect — tor/relay have dedicated booleans; suspected_vpn/vpn_suspect are corroboration-only signals that do not set is_vpn. This asymmetry with is_proxy is deliberate: suspected_proxy does set is_proxy, but suspected_vpn/vpn_suspect never set is_vpn.

Booléen. Vrai si la classification fait partie de {proxy, datacenter_proxy, mobile_proxy, suspected_proxy}. N' inclut pas les proxys résidentiels (voir is_residential_proxy). Pour trouver n'importe quel proxy, quel qu'en soit le type, combinez is_proxy OU is_residential_proxy.

Boolean. Vrai si l'adresse IP est un nœud de sortie Tor (classification « tor »).

Boolean. Vrai si la classification est « relais » — un service de relais préservant la confidentialité (par exemple, Apple Private Relay). À distinguer de « is_vpn »: les relais acheminent le trafic des utilisateurs via une sortie gérée par le fournisseur, sans point de terminaison sélectionnable par l'utilisateur.

Boolean. Vrai si l'adresse IP appartient à un centre de données ou à un hébergeur.

Boolean. Vrai si l'adresse IP appartient à un réseau de diffusion de contenu.

Boolean. True if the classification is in {residential_proxy, residential_proxy_likely, residential_proxy_mobile}. Mutually exclusive with is_proxy; use the more specific booleans below to filter further.

Booleann. Vrai si la classification == residential_proxy (niveau de précision ≥ 85 %). Sous-ensemble de is_residential_proxy.

Booléen. Vrai si classification == residential_proxy_mobile — adresses IP d'opérateurs mobiles détectées comme des proxys. Sous-ensemble de is_residential_proxy.

Boolean. Vrai lorsque l'adresse IP figure sur une liste publique de proxys ouverts. À ne pas confondre avec is_proxy: tout proxy ouvert est également un proxy, mais la plupart des proxys ne figurent pas sur les listes publiques.

Booléen. Vraie si l'adresse IP correspond à un VPN de type « appliance » (Fortinet, Pulse Secure, Cisco AnyConnect, etc.). Sous-indicateur de « is_vpn ».

Nombre entier compris entre 0 et 100. Calculé en multipliant la confiance par 100, avec une majoration de +10 pour les types de classification à haut risque.

Nombre entier ou null. Numéro du système autonome annonçant l'adresse IP.

Chaîne de caractères ou null. Nom de l'organisation enregistrée pour l'ASN.

Chaîne de caractères ou null. Nom normalisé de l'opérateur CDN (en minuscules), par exemple akamai, fastly, cloudflare, aws_cloudfront. Ne peut être différent de null que lorsque classification == cdn.

Objet ou null. Évaluation des abus au niveau ASN. Disponible sur tous les niveaux ; les niveaux premium (Growth+) bénéficient d'une analyse détaillée complète :

abuse_score — nombre entier compris entre 0 et 100, niveau d'abus pour cet ASN (tous niveaux confondus).

abuse_level — chaîne de caractères : faible, modéré, élevé, critique (tous les niveaux).

flagged_ratio — nombre à virgule flottante compris entre 0,0 et 1,0, représentant la proportion d'adresses IP signalées dans l'ASN (croissance positive).

flagged_ip_count — entier, nombre d'adresses IP signalées (croissance positive).

total_announced_ips — entier, nombre total d'adresses IP annoncées par cet ASN (croissance incluse).

Objet. Signaux de détection supplémentaires et données d'enrichissement (tous les champs sont facultatifs) :

raw_score — nombre, valeur numérique interne de confiance (0–100).

signals — objet, signaux de détection (modèles de ports, protocoles, etc.).

dns_enrichment — objet, enregistrements PTR DNS et historique RDNS.

tls_enrichment — objet, analyse des certificats TLS.

Objet ou null. Données géographiques, niveaux premium (Growth+) uniquement; null lorsqu'aucune donnée de localisation observée n'est disponible. Clés :

exit_country — chaîne de caractères ou null, code de pays ISO 3166-1 alpha-2 de l'adresse IP de sortie.

user_countries — tableau de chaînes de caractères ou valeur nulle, indiquant les pays dans lesquels des utilisateurs de cette adresse IP ont été détectés.

user_country_count — entier ou null, nombre de pays distincts des utilisateurs.

observed_lat / observed_lon — nombre ou null, coordonnées du point de sortie observé.

observed_countries — tableau de chaînes de caractères, pays dans lesquels ce concentrateur a été observé.

observation_readings — chaîne de caractères ou null, métadonnées relatives aux observations.

2 requêtes/min

30 requêtes/min

100 requêtes/min

250 requêtes/min

500 requêtes/min

Sur mesure — contactez-nous.