POST AI agent ready /v1/ip/intelligence

API IP Intelligence - Profilage IP enrichi avec données géographiques, réseau et TLS

Renvoie un profil complet de l'adresse IP de l'appelant, y compris la géolocalisation (pays, ville, région, coordonnées, appartenance à l'UE), les données réseau (ASN, organisation, DNS inversé), les indicateurs de sécurité (détection VPN avec signaux de confiance), les détails de connexion TLS (version, chiffrement, protocole) et les métadonnées de connexion Cloudflare.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/ip/intelligence \
  -H "Content-Type: application/json" \
  -d '{}'

When to use this API

Journalisation des accès sans confiance

Enregistrez le profil IP complet à chaque événement d'authentification. Capturez la géolocalisation, l'ASN, la version TLS et l'état du VPN pour créer une base de référence comportementale pour chaque utilisateur. Signalez les connexions qui s’écartent du modèle établi.

Enrichissement de la détection des robots

Combinez les données d'empreintes digitales TLS et les indicateurs VPN avec votre pipeline de détection de robots existant. Les navigateurs légitimes et les scrapers sans tête produisent différentes suites de chiffrement TLS et versions de protocole.

Empreinte digitale de connexion

Utilisez la version TLS, le chiffrement, le protocole HTTP et le temps d'aller-retour TCP pour créer une empreinte digitale de connexion. Suivez la cohérence des empreintes digitales au fil des sessions pour détecter les fraudes sans recourir aux cookies.

Frequently asked questions

Puis-je transmettre une adresse IP spécifique au profil ?

Non. Ce point de terminaison profile la propre connexion de l’appelant. Les données IP, TLS et de connexion proviennent directement du Edge Cloudflare qui traite votre demande. Pour rechercher des adresses IP arbitraires, utilisez le point de terminaison /v1/ip/lookup.

Quelle est la fiabilité de la détection VPN ?

La détection VPN utilise des heuristiques telles que les plages ASN VPN connues et les blocs IP du centre de données. Il détecte les principaux fournisseurs VPN mais ne peut pas détecter toutes les connexions VPN. Le tableau vpn_indicators explique quels signaux ont déclenché l'indicateur.

Quelles données TLS sont disponibles ?

La section TLS comprend la version TLS négociée (TLSv1.2 ou TLSv1.3), la suite de chiffrement et le protocole HTTP (h2, h3 ou http/1.1). Ces données proviennent de Cloudflare Edge et reflètent les paramètres de connexion réels.

Ce point de terminaison est-il pris en compte dans ma limite de débit ?

Oui. Cela compte comme un appel d’API comme n’importe quel autre point de terminaison. Les utilisateurs anonymes sont soumis à la limite standard de 5 requêtes/min et à la limite de 100 requêtes/jour.

Les données de géolocalisation sont-elles les mêmes que /v1/ip/lookup ?

Les champs géographiques sont de format identique. La différence est que /v1/ip/intelligence ajoute des sections réseau, sécurité, TLS et connexion que /v1/ip/lookup n'inclut pas.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.