Referencia de la API

No devuelve más que la propia dirección IP pública del cliente que hace la petición, en texto plano (Content-Type: text/plain) — p. ej. 73.9.114.155. Equivalente directo de ipinfo.io/ip: funciona igual desde curl, Wget, HTTPie o una simple visita desde el navegador (sin detección de User-Agent, a diferencia del atajo curl ipto.to anterior), y se muestra como la IP desnuda, sin elementos de página, al abrirse en un navegador.

Sin parámetros, sin cadena de consulta. Para obtener el objeto completo de geolocalización/inteligencia de amenazas, usa en su lugar GET /v1/ip más abajo. Esta ruta lee directamente la IP de la conexión (sin consulta a D1/KV) y no computa contra el presupuesto diario de peticiones — consulta Límites de peticiones.

Devuelve geolocalización e inteligencia de amenazas para la IP que realiza la petición, incluidos datos a nivel de ciudad a través del objeto edge de CF.

Sin parámetros obligatorios. Admite ?lang=, ?fields=, ?format= — consulta Localización y Formatos de salida más abajo.

Busca cualquier dirección IPv4. Los campos a nivel de ciudad (city, state, postal_code, latitude, longitude, timezone) se rellenan cuando la IP está dentro de alguno de los dos conjuntos de datos geográficos combinados, IP2Location o MaxMind — comprueba geo_precision en la respuesta para saber si has obtenido datos a nivel de ciudad o de país. El formato de timezone depende de qué fuente ha coincidido (una cadena de desfase UTC en el caso de IP2Location, un nombre IANA en el caso de MaxMind). Las búsquedas de IPv6 actualmente solo devuelven datos a nivel de país.

El endpoint de búsqueda unificada que hay detrás de la barra de búsqueda de la página de inicio. Detecta si :query es una IP, un ASN (AS15169 o 15169), un código de país de 2 letras, un correo electrónico o un número de teléfono, y a continuación agrega todas las comprobaciones relevantes en una sola respuesta. Para una consulta de IP, esto se reparte — en paralelo, en el servidor — entre la búsqueda de IP principal más RPKI, IP-to-company, operador móvil, hosted-domains y places, de modo que una sola búsqueda solo consume una petición de tu presupuesto diario de límite de peticiones, en lugar de una por función.

Cada subcampo se degrada de forma independiente — un servicio upstream lento o fallido (RIPEstat, un servidor RDAP, crt.sh) se traduce en que ese campo concreto sea null, nunca en que falle la búsqueda entera. Solo una consulta principal no válida (p. ej. una IP mal formada) devuelve un estado de error para la petición en su conjunto.

DNS inverso — una única consulta PTR en vivo a través de DNS-over-HTTPS, no una base de datos de enumeración de dominios. Devuelve null si la IP no tiene registro PTR.

Validación RPKI del origen de ruta para la ruta actualmente anunciada de una IP, resuelta en vivo a través de RIPEstat (sin ninguna base de datos de ROA ingerida ni sincronizada localmente). status solo puede ser "valid", "invalid" o "unknown" — nunca se sintetiza a partir de otra señal; cualquier fallo o tiempo de espera de RIPEstat devuelve "unknown" con una cadena de motivo, no un error.

Validación RPKI explícita (ASN, prefijo) — para cuando ya conoces la ruta exacta que quieres comprobar, en lugar de la opción derivada de IP anterior.

Identifica la organización a la que está registrada una IP combinando los datos del titular en RDAP (WHOIS estructurado) con el nombre de organización propio del ASN, en un nivel de confianza categórico, nunca una puntuación numérica.

El propio registro RDAP subyacente — bloque de red, fechas de registro/última modificación, y todos los contactos que RDAP tiene archivados. Distinto de /company, que arriba concilia estos mismos datos del titular con el nombre de organización del ASN en una única respuesta puntuada por confianza; este endpoint devuelve el registro en bruto tal cual, más parecido a la salida clásica de WHOIS. Las direcciones IPv6 también son compatibles.

Identificación de operador móvil hecha en el mejor esfuerzo posible para IPs clasificadas como redes móviles, cruzada con un directorio de operadores MCC/MNC. Deliberadamente no tiene un único campo de operador — consulta matched_carrier_entries y note más abajo — ya que un nombre de operador aislado se interpretaría como una afirmación en vivo por suscriptor, algo que estos datos no pueden respaldar honestamente.

Encuentra dominios asociados a una IP a través de su nombre de host de DNS inverso (PTR) y de los registros de transparencia de certificados (crt.sh) — no es una búsqueda de IP inversa general. El propio campo limitations de la respuesta detalla exactamente qué puede y qué no puede encontrar.

Búsqueda por lotes — hasta 100 IPs por petición, solo Pro/Enterprise. Devuelve un objeto indexado con cada IP como clave. Más rápida que las llamadas secuenciales gracias a las lecturas en paralelo de caché y base de datos. Cada IP del lote cuenta contra tu presupuesto diario de peticiones, igual que si se consultara individualmente. Las peticiones del plan gratuito reciben un 403 — consulta precios.

Busca un Sistema Autónomo por número. Devuelve el nombre de la organización, el país, el continente, el número de rangos de IP, el tipo de clasificación, el tipo de cambio y datos de referencia regionales (idiomas, TLD, capital, fronteras).

Aplica geocodificación inversa a la ubicación a nivel de ciudad ya disponible de una IP, y a continuación devuelve puntos de interés cercanos (restaurantes, parques, colegios, transporte, lugares emblemáticos), datos locales de criminalidad allí donde existe una fuente (solo Reino Unido y EE. UU.), y una estimación opcional del trayecto en coche calculada bajo demanda.

Estadísticas agregadas a nivel de país, más datos de referencia regionales (moneda, tipo de cambio, idiomas, TLD, capital, fronteras).

Analiza una cadena de User-Agent. Devuelve navegador, sistema operativo, tipo de dispositivo y detección de bots. Por defecto lee la cabecera User-Agent de quien hace la petición, o puedes pasar cualquier cadena mediante ?ua=.

Valida y formatea un número de teléfono de forma gratuita, siempre: región, tipo de línea y formato E.164/nacional/internacional mediante un analizador propio autoalojado, sin llamada a proveedores. Cuando hay un presupuesto premium mensual disponible por IP/clave (100/mes en Free, más en planes de pago — ver precios), la misma solicitud además devuelve el nombre del operador en tiempo real, el estado de portabilidad y un tipo de teléfono clasificado por el proveedor, desde un servicio de consulta de operadores en tiempo real — ver source y los campos siguientes. Se incluye siempre, independientemente del nivel, un country_name localizado junto con lang/lang_source — ver Localización. Si se agota el presupuesto premium, o hay algún problema con el servicio, la solicitud vuelve sin problemas a los campos gratuitos anteriores; nunca falla por ello. Para una referencia de operadores de red a nivel de país en lugar de una consulta por número, ver GET /v1/carriers.

Validación por lotes. Todos los planes tienen acceso a la validación por lotes (a diferencia de /v1/ip/bulk) — lo que mantiene acotado el plan Free es el límite de lote por plan, no un 403. Free: 10/petición, 100/día. Pro: 100/petición, 1.000/día. Enterprise: 1.000/petición, 10.000/día. Este presupuesto es independiente de tu límite general de peticiones diarias — consulta Límites de peticiones.

Consulta de referencia: qué operadores de red móvil (MCC/MNC) se conocen para un país dado — no vinculado a ningún número de teléfono concreto. Procede de una recopilación de MCC/MNC mantenida por la comunidad (con licencia MIT, sincronizada por última vez en 2026 — consulta el repositorio de docs para más detalles); una tabla de referencia estática, no un feed en vivo, ya que las asignaciones de planes de numeración no cambian con la frecuencia suficiente como para justificar uno.

Validación de sintaxis de correo electrónico, una comprobación en vivo del registro MX a través de DNS-over-HTTPS, y detección de dominios desechables/temporales frente a una lista de bloqueo mantenida por la comunidad (con licencia CC0, sincronizada a diario). No verifica que el buzón en sí exista — eso requiere un intercambio SMTP que esta API no realiza (consulta la referencia de campos más abajo para ver exactamente qué demuestra y qué no demuestra has_mx).

Combina los que proporciones de entre IP, correo electrónico, teléfono y User-Agent en una única puntuación de 0 a 100 — lo único que ninguno de ip-api.com, ipapi.co, ipgeolocation.io, ipify.org, ipregistry.co, ip2location.io, AbstractAPI, IPLocate.io o BigDataCloud ofrece como señal fusionada única (comprobado directamente). Las cuatro entradas son opcionales e independientes — pasa el subconjunto que quieras. ip toma por defecto tu propia IP y ua tu propia cabecera User-Agent si se omiten, la misma convención que GET /v1/ip y GET /v1/ua. Una señal que no envíes simplemente está ausente de la respuesta, no se puntúa como limpia — su peso se redistribuye entre las señales que sí proporcionaste.

Renderiza una URL en una instancia real de Chrome headless (Cloudflare Browser Rendering, no un proveedor externo de capturas de pantalla) y devuelve un PNG. Los destinos internos/privados (localhost, rangos RFC 1918, direcciones link-local/de metadatos de nube) se rechazan antes incluso de que se llegue a lanzar el navegador. Sujeto a los propios límites a nivel de plataforma de Browser Rendering, que son mucho más estrictos que los del resto de esta API — en los planes de Cloudflare más bajos, es de esperar que esto limite la frecuencia bastante antes de que lo haga tu presupuesto diario habitual de peticiones.

Identifica el idioma de un fragmento de texto mediante análisis local de frecuencia de trigramas — sin llamadas a proveedores externos, sin inferencia de modelos de IA, sin registro de datos. Una entrada de menos de 10 caracteres devuelve un idioma null; con menos de ~30 caracteres aún puede devolver una estimación, pero reliable será false.

Convierte un importe entre dos monedas (154 admitidas) usando el mismo feed diario de tipos de cambio de referencia que ya alimenta currency_code/exchange_rate_usd en cada búsqueda de IP, ASN y país — expuesto aquí como un endpoint de conversión independiente en lugar de anidado dentro de una respuesta de geolocalización.

Tabla completa de tipos de cambio (154 monedas) rebasada respecto a cualquier moneda admitida, no solo USD.

Historial diario del tipo de cambio de referencia para un par de monedas, hasta 90 días atrás — los datos que hay detrás del gráfico de tendencia de tipos en la herramienta de conversión de moneda. Se rellena una vez de forma retroactiva y después se añade a diario mediante el mismo cron que actualiza GET /v1/currency/convert. Se trata de un único tipo de cambio de referencia diario a lo largo del tiempo, no un spread de compra/venta de trading.

Condiciones actuales — y, con detail=1, una previsión por horas y un pronóstico de varios días — para un nombre de lugar, un código postal o un par "lat,lon", o para lat + lon o una ip. Los lugares de EE. UU. los atiende el National Weather Service y el resto del mundo MET Norway. Añade include= para obtener el documento completo con unidades, hasta 9 días, sol y luna, alertas oficiales y más — consulta la tarjeta include más abajo. La herramienta weather-lookup detecta además automáticamente la ubicación del propio usuario en el navegador antes de llamar a este endpoint de forma explícita.

Proxy en vivo al sistema Trademark Status & Document Retrieval (TSDR) de la USPTO para el estado de un expediente por número de serie de 8 dígitos — una llamada directa por petición, no una copia almacenada en caché ni revendida. Los datos de estado de expediente son una obra del gobierno de EE. UU. y de dominio público según los propios términos de uso de la USPTO, por lo que cada respuesta incluye un campo source/attribution en lugar de almacenarlos en caché o revenderlos de forma silenciosa. Los datos de logotipo/imagen de la marca quedan deliberadamente fuera de alcance — los términos de la USPTO separan las licencias de imagen de los datos de texto sobre el estado del expediente que devuelve este endpoint. La búsqueda por número de registro aún no es compatible; hoy la USPTO solo documenta la ruta por número de serie. Pruébalo en la herramienta Trademark Lookup.

Proxy en vivo a la API Patent File Wrapper de la USPTO (Open Data Portal) para el estado de concesión por número de patente de utilidad de 7-8 dígitos — una llamada directa por petición, no una copia almacenada en caché ni revendida. Se confirmó que la fuente originalmente utilizada (la Search API de PatentsView) se cerró el 2026-03-20; esto sirve de proxy a su sucesora en vivo. Los datos de Patent File Wrapper son una obra del gobierno de EE. UU. y de dominio público según los propios términos de uso de la USPTO, por lo que cada respuesta incluye un campo source/attribution. El alcance se centra en la solicitud/tramitación — sin grafo de citas, familia de patentes, campo de estado legal ni imágenes como sí muestran Lens.org, Espacenet o Google Patents. La cobertura empieza en las solicitudes presentadas en 2001. Las patentes de diseño, de planta y las reemisiones aún no son compatibles; solo patentes de utilidad por número de patente concedida. Pruébalo en la herramienta Patent Lookup.

Feed paginado de VPN, Tor e inteligencia de amenazas. 200 entradas por página. Cada entrada incluye IP/CIDR, atribución de proveedor, ISP, país y tipo de clasificación.

Solo metadatos — recuento total de entradas, recuentos por fuente y hora de la última sincronización. No devuelve datos de IP.

Rangos de red abusivos paginados. Puntuados de 1 a 10 mediante corroboración cruzada de feeds. Niveles de riesgo: critical (8-10), high (5-7), medium (3-4).

Solo metadatos — recuento total de redes, recuentos por fuente, desglose por nivel de riesgo y hora de la última sincronización.

Exportación CSV descargable de los conjuntos de datos abiertos sobre los que ya se construye la API — los mismos datos, sin nueva licencia. asn y ranges están siempre disponibles; geo-city devuelve 503 hasta que el conjunto de datos de esa fuente esté activo en un despliegue concreto. geo-city exporta las filas en bruto de una fuente geográfica cada vez, no una vista combinada — pasa ?source=primary (por defecto) o ?source=secondary.

Emite una clave de API al instante — sin correo electrónico, sin registro. Toda clave empieza en el plan Free (1.000 peticiones/día; búsqueda masiva no incluida). Las claves Pro y Enterprise desbloquean límites diarios más altos y búsqueda masiva (hasta 100 IPs/petición) — consulta precios. Guarda la clave — no se podrá recuperar más adelante.

Comprueba cuántas peticiones ha hecho una clave. Pasa la clave en cualquier petición /v1/* mediante la cabecera X-API-Key o ?api_key= para que se contabilice.

Contacto para denuncias de abuso de la red propietaria de una IP, a partir de RDAP: el RIR, el identificador de la red, el CIDR que la cubre y los buzones de abuso. Sirve para saber a dónde enviar una denuncia.

available es false (con un motivo en failure) cuando no se pudo contactar con el registro.

Los rangos de IP que un ASN anuncia realmente, paginados, cada uno con su país y los indicadores de alojamiento / móvil / residencial / bot / lista negra.

Registro (RDAP) de un ASN: identificador, nombre, país, tipo de asignación, fechas de registro, el RIR y sus contactos.

available es false con un reason cuando el registro no está disponible.

Otros ASN probablemente relacionados con este: primero la misma organización registrada, después el mismo país y tipo.

Dónde está realmente un ASN: puntos a nivel de ciudad geolocalizados a partir de una muestra de sus rangos más grandes, más las ciudades más frecuentes. Alimenta el mapa de distribución de la página del ASN.

Una muestra, no la lista completa de rangos. Use /v1/asn/:asn/ranges para todos los rangos.

Dominios alojados en un ASN, hallados mediante DNS inverso (PTR) sobre una muestra de sus direcciones. Cada entrada incluye el dominio raíz, el nombre de host PTR y la IP muestreada.

Es una muestra, así que orienta sobre lo que aloja el ASN, no es una lista completa. Para una sola IP use /v1/ip/:ip/hosted-domains.

Relaciones BGP de un ASN: pares, proveedores upstream y clientes downstream, con sus recuentos.

available es false cuando no se pudo contactar con la fuente de datos BGP. Los arrays vacíos con available: true significan que no se informó nada para ese ASN.

Directorio del espacio IPv4: una entrada por bloque /8 con cuántos rangos, países y ASN contiene y su país principal. Empiece aquí y profundice con /v1/ip-ranges/:a y /v1/ip-ranges/:a/:b.

Los bloques /16 dentro de un /8 (por ejemplo 8.0.0.0/8), con los mismos recuentos de rangos, países y ASN por bloque.

Los rangos asignados dentro de un /16 (por ejemplo 8.8.0.0/16), cada uno con el ASN al que pertenece, más los recuentos por bloque.

Una porción de la carga de Nearby para una coordenada, para que el cliente muestre cada parte según llega: geocodificación inversa, puntos de interés o estadísticas locales de criminalidad.

Tiempo y distancia en coche entre dos puntos. Una vía rápida: omite la geocodificación inversa y la búsqueda de puntos de interés que hace /v1/places/:ip.

Cuando no se puede resolver ningún destino, la respuesta incluye to: null, commute: null y una cadena reason.

La carga de /v1/places/:ip anclada en una dirección escrita en lugar de una IP: geocodificación, localidad y una estimación opcional del trayecto.

found es false cuando no se pudo geocodificar la dirección.

Autocompletado de direcciones: unos pocos lugares que coinciden con una dirección parcial, con preferencia opcional por un punto.

El documento meteorológico completo, para el nombre de un lugar, un código postal, coordenadas o una IP. Elige los bloques que necesites con include: current, hourly, daily, astro (sol y luna), solar, indicators, alerts, marine, air_quality, nowcast o all. Los lugares de EE. UU. proceden del National Weather Service y el resto del mundo de MET Norway; meta.source indica cuál. Sin include recibes el formato simple { query, weather } descrito arriba.

meta.coverage indica qué campos existen para el lugar: la probabilidad de lluvia, las ráfagas y la probabilidad de tormenta solo existen en EE. UU. y los países nórdicos, y valen null (nunca cero) en el resto. alerts son avisos oficiales de EE. UU. y Noruega; marine, air_quality y nowcast solo cubren Noruega y aguas cercanas e indican available: false en otros lugares. Todo lo que aparece en meta.derived es una estimación de ipto.to, e indicators son señales derivadas, no avisos oficiales. Conserva meta.attribution si muestras los datos (los datos de MET Norway son CC BY 4.0).

El registro diario propio de ipto.to para lugares ya consultados: la máxima más alta, la mínima más baja y la mayor precipitación vistas en las instantáneas de previsión del día. Solo los lugares ya solicitados tienen datos, que se acumulan con el tiempo.

Son instantáneas de previsión, no observaciones de estaciones ni reanálisis, así que no las uses como historial observado. 404 significa que aún no se ha registrado ninguna instantánea para ese lugar.

Los fotogramas de animación de radar disponibles, del más antiguo al más reciente, cada uno con una marca de tiempo Unix y el id de fotograma que se usa en la URL del tile de radar.

Un tile de mapa de radar (PNG) para un fotograma, en una posición z/x/y estándar de mapa web. Se sirve desde el mismo origen para que un mapa lo cargue sin una petición a terceros.

Un tile de mapa de imágenes de satélite para una posición z/x/y estándar de mapa web, servido desde el mismo origen.

Contrato OpenAPI 3.1 legible por máquinas para /v1/email/:email, escrito para que los agentes LLM y MCP llamen al endpoint de correo sin leer esta documentación.