Documentación — IPRapid

API

API HTTP y JSON

Sin autenticación

Los endpoints principales no requieren cuenta ni cookie. Las respuestas dinámicas usan Cache-Control: no-store y cabeceras de límite de solicitudes.

API v1

JSON estable

JSON snake_case versionado para consultas propias y de destino con contrato de respuesta estable.

GET/api/v1/self

Resultado estructurado de la IP actual con campos de red, ubicación y ASN.

curl --fail --silent --show-error https://iprapid.com/api/v1/self

GET/api/v1/lookup/{ip}

Consulta estructurada de una dirección IPv4 o IPv6 validada.

curl --fail --silent --show-error https://iprapid.com/api/v1/lookup/8.8.8.8

GET/api/v1/meta

schema_version · capabilities · fields

curl --fail --silent --show-error https://iprapid.com/api/v1/meta

JSON

Compatibilidad

Ruta	Respuesta
`GET /`	Raíz con negociación de contenido: JSON para CLI y /, una IP para text/plain y HTML SSR cuando se solicita text/html explícitamente.
`GET /json`	Resultado estructurado de la IP actual con campos de red, ubicación y ASN.
`GET /json/{ip}`	Consulta estructurada de una dirección IPv4 o IPv6 validada.
`GET /ip/{ip}`	IP de destino normalizada para clientes automáticos; página noindex solo ante una petición HTML explícita.

curl -sS https://iprapid.com/json
curl -sS https://iprapid.com/json/8.8.8.8

Terminal

TEXT / ANSI

Ruta	Respuesta
`GET /ip`	IP actual normalizada seguida de un salto de línea.
`GET /info[/{ip}]`	Texto UTF-8 detallado, con etiquetas y orden estables y sin controles ANSI.
`GET /ansi[/{ip}]`	Vista /info con color SGR permitido y activado expresamente.
`GET /field/{field}[/{ip}]`	Un valor permitido seguido de un salto de línea; 204 si no está disponible.

curl iprapid.com
curl -4 iprapid.com
curl -6 iprapid.com

curl.exe iprapid.com
curl.exe -4 iprapid.com
curl.exe -6 iprapid.com

API v1 · JSON

APPLICATION/JSON

{
  "schema_version": "1",
  "query": {
    "type": "lookup",
    "ip": "8.8.8.8",
    "ip_version": 4
  },
  "network": {
    "asn": 15169,
    "as_organization": "Google LLC"
  },
  "location": {
    "continent_code": "NA",
    "country_code": "US",
    "country": "United States",
    "region_code": null,
    "region": null,
    "city": null,
    "postal_code": null,
    "timezone": "America/Chicago",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822,
      "accuracy_radius_km": 1000
    }
  },
  "data": {
    "status": "available",
    "built_at": "2026-03-03T08:15:43Z"
  },
  "observed_at": "2026-07-25T12:23:07Z"
}

Metodología y límites de las señales

El servicio separa los datos de red observados por el servidor, los conjuntos geográficos locales y las evidencias del navegador para no confundir señales distintas.

La IP pública mostrada es la dirección observada por el servicio en esta conexión HTTP.
El país, región, ciudad, zona horaria, coordenadas, ASN y organización proceden de un conjunto de datos local.
Las pruebas de WebRTC, DNS, idioma, zona horaria e IPv6 son observaciones independientes realizadas en el navegador.
No disponible, desconocido, sin observación y discrepancia son estados diferentes.

Precisión y actualización

La geolocalización IP describe una asignación de red, no un dispositivo ni un domicilio. La ciudad y las coordenadas pueden estar alejadas; el radio de precisión es una estimación, no una garantía.

Privacidad y conservación

La consulta no guarda IP sin procesar, URI, cabeceras ni huellas en los agregados PostgreSQL. Los enlaces firmados solo contienen estados reducidos, caducan en 24 horas y no se guardan como registros.

Preguntas frecuentes

¿La ciudad mostrada es mi ubicación exacta?

No. La geolocalización IP es una estimación aproximada a nivel de red. Consulte el radio de precisión y no la trate como una dirección exacta.

¿Guarda el servicio mi consulta de IP en su base de datos?

La aplicación no guarda direcciones IP sin procesar en sus agregados de uso. Los registros web restringidos se gestionan por separado.

¿Por qué IPv6 puede aparecer como desconocido y no como no disponible?

Una prueba no configurada, bloqueada o no concluyente no demuestra que IPv6 esté ausente; el estado sigue desconocido hasta obtener un resultado claro.

¿Qué contiene un enlace de diagnóstico compartido?

Solo estados reducidos, horas de emisión y caducidad y una firma; no contiene IP, coordenadas ni direcciones de resolutores DNS.