Référence API

Ne renvoie que la propre adresse IP publique du client à l'origine de la requête, en texte brut (Content-Type: text/plain) — ex. 73.9.114.155. Équivalent direct de ipinfo.io/ip : fonctionne à l'identique depuis curl, Wget, HTTPie, ou une simple visite dans un navigateur (pas de détection du User-Agent, contrairement au raccourci curl ipto.to ci-dessus), et s'affiche comme une IP nue sans habillage de page lorsqu'il est ouvert dans un navigateur.

Aucun paramètre, aucune chaîne de requête. Pour l'objet complet de géolocalisation/renseignement sur les menaces, utilisez plutôt GET /v1/ip ci-dessous. Cette route lit directement l'IP de connexion (sans recherche D1/KV) et n'est pas comptabilisée dans le quota de requêtes quotidien — voir Limites de débit.

Renvoie la géolocalisation et le renseignement sur les menaces pour l'IP à l'origine de la requête, y compris des données au niveau de la ville via l'objet edge de CF.

Aucun paramètre requis. Accepte ?lang=, ?fields=, ?format= — voir Localisation et Formats de sortie ci-dessous.

Recherchez n'importe quelle adresse IPv4. Les champs de niveau ville (city, state, postal_code, latitude, longitude, timezone) sont renseignés lorsque l'IP appartient à l'un des deux jeux de données géo fusionnés, IP2Location ou MaxMind — vérifiez geo_precision dans la réponse pour savoir si vous avez obtenu des données au niveau ville ou pays. Le format de timezone dépend de la source ayant fourni la correspondance (une chaîne de décalage UTC pour IP2Location, un nom IANA pour MaxMind). Les recherches IPv6 ne renvoient actuellement que des données au niveau pays.

L'endpoint de recherche unifié derrière la barre de recherche de la page d'accueil. Détecte si :query est une IP, un ASN (AS15169 ou 15169), un code pays à 2 lettres, un e-mail, ou un numéro de téléphone, puis agrège chaque vérification pertinente en une seule réponse. Pour une requête IP, cela se répartit — en parallèle, côté serveur — sur la recherche IP principale plus RPKI, IP-vers-entreprise, opérateur mobile, domaines hébergés et lieux, de sorte qu'une seule recherche ne consomme qu'une seule requête sur votre quota quotidien de débit, au lieu d'une par fonctionnalité.

Chaque sous-champ se dégrade indépendamment — un service amont lent ou en échec (RIPEstat, un serveur RDAP, crt.sh) se traduit par ce seul champ à null, jamais par l'échec de la recherche entière. Seule une requête principale invalide (par ex. une IP malformée) renvoie un statut d'erreur pour la requête dans son ensemble.

DNS inversé — une seule recherche PTR en direct via DNS-over-HTTPS, pas une base de données d'énumération de domaines. Renvoie null si l'IP n'a pas d'enregistrement PTR.

Validation RPKI de l'origine de route pour la route actuellement annoncée d'une IP, résolue en direct via RIPEstat (aucune base de données ROA ingérée ou synchronisée localement). status vaut uniquement "valid", "invalid", ou "unknown" — jamais synthétisé à partir d'un autre signal ; tout échec ou dépassement de délai de RIPEstat renvoie "unknown" accompagné d'une chaîne reason, jamais une erreur.

Validation RPKI explicite (ASN, préfixe) — pour lorsque vous connaissez déjà la route exacte à vérifier, plutôt que la commodité dérivée de l'IP ci-dessus.

Identifie l'organisation à laquelle une IP est enregistrée en combinant les données du titulaire RDAP (WHOIS structuré) avec le nom d'organisation propre de l'ASN, pour obtenir une confiance catégorielle, jamais un score numérique.

L'enregistrement RDAP sous-jacent lui-même — bloc réseau, dates d'enregistrement/de dernière modification, et tous les contacts que RDAP a en fichier. Distinct de /company ci-dessus, qui réconcilie ces mêmes données de titulaire avec le nom d'organisation de l'ASN en une seule réponse assortie d'un score de confidence ; cet endpoint renvoie l'enregistrement brut tel quel, plus proche d'une sortie WHOIS classique. Les adresses IPv6 sont également prises en charge.

Identification de l'opérateur mobile au mieux pour les IP classées comme réseaux mobiles, croisée avec un annuaire d'opérateurs MCC/MNC. N'a délibérément pas de champ carrier unique — voir matched_carrier_entries et note ci-dessous — car un simple nom d'opérateur se lirait comme une affirmation en direct au niveau de l'abonné, ce que ces données ne peuvent pas honnêtement garantir.

Trouve les domaines associés à une IP via son nom d'hôte DNS inversé (PTR) et les journaux de transparence des certificats (crt.sh) — pas une recherche IP inversée générale. Le champ limitations de la réponse précise exactement ce que cela peut et ne peut pas trouver.

Recherche par lot — jusqu'à 100 IP par requête, réservé Pro/Enterprise. Renvoie un objet indexé avec chaque IP comme clé. Plus rapide que des appels séquentiels grâce aux lectures parallèles du cache et de la base de données. Chaque IP du lot compte dans votre quota de requêtes quotidien, comme une recherche individuelle. Les requêtes du niveau gratuit reçoivent un 403 — voir tarifs.

Recherchez un système autonome par son numéro. Renvoie le nom de l'organisation, le pays, le continent, le nombre de plages IP, le type de classification, le taux de change, et des données de référence locales (langues, tld, capitale, frontières).

Géocode inversement la localisation existante au niveau ville d'une IP, puis renvoie les points d'intérêt à proximité (restaurants, parcs, écoles, transports, sites remarquables), des données de criminalité locales lorsqu'une source existe (Royaume-Uni et États-Unis uniquement), et une estimation de trajet en voiture optionnelle et à la demande.

Statistiques agrégées au niveau pays plus des données de référence locales (devise, taux de change, langues, tld, capitale, frontières).

Analyse une chaîne User-Agent. Renvoie le navigateur, l'OS, le type d'appareil, et la détection de bot. Lit par défaut l'en-tête User-Agent de l'appelant, ou transmettez n'importe quelle chaîne via ?ua=.

Valide et formate un numéro de téléphone gratuitement, toujours : région, type de ligne, et formatage E.164/national/international via un analyseur auto-hébergé, sans appel à un fournisseur. Lorsqu'un budget premium mensuel par IP/clé est disponible (100/mois sur Free, plus sur les plans payants — voir tarifs), la même requête renvoie en plus un nom d'opérateur en direct, le statut de portabilité, et un type de téléphone classifié par le fournisseur, depuis un service de recherche d'opérateur en temps réel — voir source et les champs ci-dessous. Un country_name localisé ainsi que lang/lang_source sont toujours inclus, quel que soit le niveau — voir Localisation. L'épuisement du budget premium, ou tout problème en amont, entraîne un retour sans accroc aux champs gratuits ci-dessus ; la requête n'échoue jamais pour cette raison. Pour une référence des opérateurs réseau au niveau pays plutôt qu'une recherche par numéro, voir GET /v1/carriers.

Validation par lot. Chaque niveau a accès au traitement par lot (contrairement à /v1/ip/bulk) — c'est le plafond de lot par niveau qui limite le niveau gratuit, pas un 403. Gratuit : 10/requête, 100/jour. Pro : 100/requête, 1 000/jour. Enterprise : 1 000/requête, 10 000/jour. Ce quota est distinct de votre limite de requêtes quotidienne générale — voir Limites de débit.

Recherche de référence : quels opérateurs de réseau mobile (MCC/MNC) sont connus pour un pays donné — sans lien avec un numéro de téléphone spécifique. Provient d'une compilation MCC/MNC maintenue par la communauté (sous licence MIT, dernière synchronisation en 2026 — voir le dépôt docs pour plus de détails) ; une table de référence statique, pas un flux en direct, car les attributions de plans de numérotation ne changent pas assez souvent pour en justifier un.

Validation de la syntaxe d'un e-mail, vérification en direct de l'enregistrement MX via DNS-over-HTTPS, et détection de domaine jetable/temporaire par rapport à une liste noire maintenue par la communauté (sous licence CC0, synchronisée quotidiennement). Ne vérifie pas que la boîte aux lettres elle-même existe — cela nécessiterait une négociation SMTP que cette API n'effectue pas (voir la référence des champs ci-dessous pour savoir exactement ce que has_mx prouve et ne prouve pas).

Combine ceux que vous fournissez parmi IP, e-mail, téléphone, et User-Agent en un seul score de 0 à 100 — la seule chose qu'aucun de ip-api.com, ipapi.co, ipgeolocation.io, ipify.org, ipregistry.co, ip2location.io, AbstractAPI, IPLocate.io, ou BigDataCloud n'offre comme signal unique fusionné (vérifié directement). Les quatre entrées sont optionnelles et indépendantes — transmettez n'importe quel sous-ensemble. ip prend par défaut votre propre IP et ua votre propre en-tête User-Agent si omis, même convention que GET /v1/ip et GET /v1/ua. Un signal que vous ne transmettez pas est simplement absent de la réponse, il n'est pas noté comme propre — son poids est redistribué entre les signaux que vous avez effectivement fournis.

Restitue une URL dans une véritable instance Chrome headless (Cloudflare Browser Rendering, pas un fournisseur tiers de captures d'écran) et renvoie un PNG. Les cibles internes/privées (localhost, plages RFC 1918, adresses link-local/métadonnées cloud) sont rejetées avant même le lancement du navigateur. Soumis aux propres limites, au niveau plateforme, de Browser Rendering, bien plus strictes que le reste de cette API — attendez-vous à une limitation bien avant que votre quota de requêtes quotidien habituel ne soit atteint sur les plans Cloudflare inférieurs.

Identifie la langue d'un texte via une analyse locale de fréquence de trigrammes — aucun appel à un fournisseur externe, aucune inférence par modèle d'IA, aucune journalisation. Une entrée de moins de 10 caractères renvoie une langue à null ; en dessous d'environ 30 caractères, une meilleure estimation peut encore être renvoyée mais reliable vaudra false.

Convertit un montant entre deux devises (154 prises en charge) en utilisant le même flux quotidien de taux de référence qui alimente déjà currency_code/exchange_rate_usd sur chaque recherche IP, ASN, et pays — exposé ici comme un endpoint de conversion autonome plutôt qu'imbriqué dans une réponse de géolocalisation.

Table complète des taux de change (154 devises) rebasée sur n'importe quelle devise prise en charge, pas seulement l'USD.

Historique quotidien des taux de référence pour une paire de devises, jusqu'à 90 jours en arrière — les données derrière le graphique de tendance des taux sur l'outil de conversion de devises. Rempli une fois rétroactivement, puis complété quotidiennement par le même cron qui met à jour GET /v1/currency/convert. Il s'agit d'un unique taux de référence quotidien dans le temps, pas d'un écart de cours acheteur/vendeur.

Conditions actuelles — et, avec detail=1, des prévisions horaires et sur plusieurs jours — pour un nom de lieu, un code postal ou une paire "lat,lon", ou pour lat + lon ou une ip. Les lieux américains sont servis par le National Weather Service, le reste du monde par MET Norway. Ajoutez include= pour le document complet avec unités, jusqu'à 9 jours, soleil et lune, alertes officielles et plus — voir la carte include ci-dessous. L'outil weather-lookup détecte en outre automatiquement la position de l'appelant côté navigateur avant tout appel explicite à ce point de terminaison.

Proxy en direct vers le système Trademark Status & Document Retrieval (TSDR) de l'USPTO pour le statut d'un dossier via un numéro de série à 8 chiffres — un appel direct par requête, pas une copie mise en cache ou revendue. Les données de statut de dossier constituent une œuvre du gouvernement américain et relèvent du domaine public selon les propres conditions d'utilisation de l'USPTO ; chaque réponse comporte donc un champ source/attribution plutôt que d'être mise en cache ou revendue silencieusement. Les données de logo/image de marque sont délibérément hors périmètre — les conditions de l'USPTO isolent les licences d'image séparément des données textuelles de statut de dossier renvoyées par cet endpoint. La recherche par numéro d'enregistrement n'est pas encore prise en charge ; seul le chemin par numéro de série est documenté par l'USPTO à ce jour. Essayez-le sur l'outil Recherche de marque.

Proxy en direct vers l'API Patent File Wrapper (Open Data Portal) de l'USPTO pour le statut de délivrance via un numéro de brevet d'utilité à 7-8 chiffres — un appel direct par requête, pas une copie mise en cache ou revendue. La source initialement visée (l'API de recherche de PatentsView) a été confirmée fermée le 2026-03-20 ; ceci fait plutôt proxy vers son successeur en direct. Les données Patent File Wrapper constituent une œuvre du gouvernement américain et relèvent du domaine public selon les propres conditions d'utilisation de l'USPTO, chaque réponse comportant donc un champ source/attribution. Le périmètre est centré sur la demande/procédure — aucun graphe de citations, famille de brevets, champ de statut juridique, ou images comme le montrent Lens.org, Espacenet, ou Google Patents. La couverture démarre avec les demandes déposées en 2001. Les brevets de dessin, de plante, et de réémission ne sont pas encore pris en charge ; seuls les brevets d'utilité par numéro de brevet délivré. Essayez-le sur l'outil Recherche de brevet.

Flux paginé de VPN, Tor, et renseignement sur les menaces. 200 entrées par page. Chaque entrée inclut IP/CIDR, attribution du fournisseur, FAI, pays, et type de classification.

Métadonnées uniquement — nombre total d'entrées, nombre par source, et heure de dernière synchronisation. Ne renvoie pas de données IP.

Plages réseau abusives paginées. Notées de 1 à 10 par corroboration croisée des flux. Niveaux de risque : critical (8-10), high (5-7), medium (3-4).

Métadonnées uniquement — nombre total de réseaux, nombre par source, répartition des niveaux de risque, et heure de dernière synchronisation.

Export CSV téléchargeable des jeux de données ouverts sur lesquels l'API est déjà construite — mêmes données, aucune nouvelle licence. asn et ranges sont toujours disponibles ; geo-city renvoie 503 tant que le jeu de données de cette source n'est pas actif sur un déploiement donné. geo-city exporte les lignes brutes d'une seule source géo à la fois, pas une vue fusionnée — transmettez ?source=primary (par défaut) ou ?source=secondary.

Délivre une clé API instantanément — aucun e-mail, aucune inscription. Chaque clé démarre sur le niveau gratuit (1 000 requêtes/jour ; recherche en masse non incluse). Les clés Pro et Enterprise débloquent des limites quotidiennes plus élevées et la recherche en masse (jusqu'à 100 IP/requête) — voir tarifs. Conservez la clé — elle ne pourra pas être récupérée ultérieurement.

Vérifiez combien de requêtes une clé a effectuées. Transmettez la clé sur n'importe quelle requête /v1/* via l'en-tête X-API-Key ou ?api_key= pour qu'elle soit comptabilisée.

Contact de signalement d'abus du réseau propriétaire d'une IP, d'après RDAP : le RIR, l'identifiant du réseau, le CIDR qui le couvre et la ou les adresses e-mail d'abus. Utile pour savoir où envoyer un signalement.

available vaut false (avec un motif dans failure) lorsque le registre n'a pas pu être joint.

Les plages d'IP réellement annoncées par un ASN, paginées, chacune avec son pays et les indicateurs hébergement / mobile / résidentiel / bot / liste noire.

Enregistrement du registre (RDAP) d'un ASN : identifiant, nom, pays, type d'allocation, dates d'enregistrement, le RIR et ses contacts.

available vaut false avec un reason lorsque le registre est injoignable.

Autres ASN probablement liés à celui-ci : d'abord la même organisation enregistrée, puis le même pays et le même type.

Où se trouve réellement un ASN : des points au niveau de la ville, géolocalisés à partir d'un échantillon de ses plus grandes plages, plus les villes les plus fréquentes. Alimente la carte de répartition de la page ASN.

Un échantillon, pas la liste complète des plages. Utilisez /v1/asn/:asn/ranges pour toutes les plages.

Domaines hébergés dans un ASN, trouvés par DNS inverse (PTR) sur un échantillon de ses adresses. Chaque entrée contient le domaine racine, le nom d'hôte PTR et l'IP échantillonnée.

Échantillonné : c'est un indice de ce que l'ASN héberge, pas une liste complète. Pour une seule IP, utilisez /v1/ip/:ip/hosted-domains.

Relations BGP d'un ASN : pairs, fournisseurs amont et clients aval, avec leur nombre.

available vaut false lorsque la source de données BGP n'a pas pu être jointe. Des tableaux vides avec available: true signifient que rien n'a été signalé pour cet ASN.

Annuaire de l'espace IPv4 : une entrée par bloc /8 avec le nombre de plages, de pays et d'ASN qu'il contient et son pays principal. Commencez ici, puis descendez avec /v1/ip-ranges/:a et /v1/ip-ranges/:a/:b.

Les blocs /16 d'un /8 (par exemple 8.0.0.0/8), avec les mêmes nombres de plages, de pays et d'ASN par bloc.

Les plages attribuées dans un /16 (par exemple 8.8.0.0/16), chacune avec l'ASN auquel elle appartient, plus les nombres par bloc.

Une tranche de la charge Nearby pour une coordonnée, afin qu'un client affiche chaque partie à mesure qu'elle arrive : géocodage inverse, points d'intérêt ou statistiques locales de criminalité.

Durée et distance en voiture entre deux points. Un chemin rapide : il évite le géocodage inverse et la recherche de points d'intérêt de /v1/places/:ip.

Lorsqu'aucune destination ne peut être résolue, la réponse contient to: null, commute: null et une chaîne reason.

La charge de /v1/places/:ip ancrée sur une adresse postale saisie au lieu d'une IP : géocodage, localité et estimation de trajet facultative.

found vaut false lorsque l'adresse n'a pas pu être géocodée.

Autocomplétion d'adresses : quelques lieux correspondant à une adresse partielle, avec une préférence facultative pour un point.

Le document météo complet, pour un nom de lieu, un code postal, des coordonnées ou une IP. Choisissez les blocs voulus avec include : current, hourly, daily, astro (soleil et lune), solar, indicators, alerts, marine, air_quality, nowcast, ou all. Les lieux américains viennent du National Weather Service, le reste du monde de MET Norway ; meta.source indique lequel. Sans include, vous obtenez le format simple { query, weather } décrit plus haut.

meta.coverage indique les champs disponibles pour le lieu : la probabilité de pluie, les rafales et la probabilité d'orage n'existent qu'aux États-Unis et dans les pays nordiques, et valent null (jamais zéro) ailleurs. alerts sont des alertes officielles pour les États-Unis et la Norvège ; marine, air_quality et nowcast ne couvrent que la Norvège et ses eaux proches et renvoient available: false ailleurs. Tout ce qui figure dans meta.derived est une estimation d'ipto.to, et indicators sont des signalements dérivés, pas des alertes officielles. Conservez meta.attribution si vous affichez ces données (les données de MET Norway sont sous licence CC BY 4.0).

Le relevé quotidien propre à ipto.to pour les lieux déjà consultés : la température maximale la plus haute, la minimale la plus basse et les plus fortes précipitations vues dans les instantanés de prévision de la journée. Seuls les lieux déjà demandés ont des données, qui s'accumulent avec le temps.

Ce sont des instantanés de prévision, pas des observations de station ni une réanalyse : ne les utilisez pas comme historique observé. Un 404 signifie qu'aucun instantané n'a encore été enregistré pour ce lieu.

Les images d'animation radar disponibles, de la plus ancienne à la plus récente, chacune avec un horodatage Unix et l'identifiant d'image à utiliser dans l'URL de la tuile radar.

Une tuile de carte radar (PNG) pour une image, à une position z/x/y standard de carte web. Servie depuis la même origine pour qu'une carte la charge sans requête tierce.

Une tuile de carte d'imagerie satellite pour une position z/x/y standard de carte web, servie depuis la même origine.

Contrat OpenAPI 3.1 lisible par machine pour /v1/email/:email, écrit pour que les agents LLM et MCP appellent le point de terminaison e-mail sans lire cette documentation.