Centro para desarrolladores de ZipCheckup

Acceda a datos de seguridad del hogar a nivel de código postal para más de 85,358 códigos postales de EE. UU. API gratuita, datos abiertos (CC BY 4.0), cero dependencias.

Inicio rápido

Una solicitud, una respuesta JSON. No se necesita clave de API para el plan gratuito.

Solicitud
GET https://zipcheckup.com/api/v1/zip/90210
Respuesta — JSON
{
  "zip":          "90210",
  "score":        72,
  "grade":        "B",
  "violations":   3,
  "lead_level":   "low",
  "radon_zone":   2,
  "flood_claims": 148,
  "components":   {
    "water_quality": 78,
    "lead_risk":     85,
    "radon_risk":    62,
    "flood_risk":    55,
    "air_quality":   71
  },
  "home_value":    {
    "median":           1250000,
    "remediation_cost": 4200,
    "equity_trap_ratio":0.34,
    "purchase_risk_pct":2.1
  }
}

Límite de uso: 100 solicitudes al día en el plan gratuito. No requiere autenticación. Vea la documentación completa de la API para todos los parámetros y campos de respuesta.

Endpoints de la API

API REST con JSON. Todos los endpoints aceptan solicitudes GET y devuelven JSON.

Método Endpoint Descripción
GET /api/v1/zip/{code} Reporte completo del código postal — puntaje, calificación, infracciones y desglose por componente
GET /api/v1/state/{code} Resumen a nivel estatal — promedios, peores códigos postales y conteo de infracciones
GET /api/v1/rankings/{metric} Rankings nacionales o estatales por métrica (puntaje, plomo, radón, inundaciones)
GET /badge/{zip}.svg Insignia SVG con el puntaje, lista para incrustar en cualquier código postal

Para documentación detallada de parámetros, esquemas de respuesta y códigos de error, vea la referencia completa de la API.

Casos de uso

Desarrolladores, periodistas e investigadores usan los datos de ZipCheckup en distintos sectores.

Plataformas de bienes raíces

Muestre puntajes de seguridad del hogar en listados de propiedades. Ayude a los compradores a comparar vecindarios por calidad del agua, riesgo de inundación, factores ambientales, valores medianos de vivienda, costos estimados de remediación y proporciones de trampa de plusvalía.

Suscripción de seguros

Enriquezca los modelos de riesgo con reclamos de inundación a nivel de código postal, zonas de radón y antigüedad de la infraestructura de agua para una tarificación de primas más precisa.

Inspección de viviendas

Genere reportes previos a la inspección con contexto ambiental local. Marque áreas de alto riesgo por problemas de plomo, radón o calidad del agua.

Periodismo

Investigue historias locales de calidad del agua con datos. Descargue conjuntos de datos, compare códigos postales y cite estadísticas de fuentes gubernamentales.

Investigación académica

Acceda a datos estructurados de salud ambiental para estudios sobre contaminación del agua, justicia ambiental y desigualdades en salud pública.

Aplicaciones de hogar inteligente

Integre datos locales de calidad del agua en paneles de hogar inteligente. Sugiera filtros de agua según los niveles reales de contaminantes en el código postal del usuario.

Blockchain y contratos inteligentes

Acceda a datos de calidad del agua on-chain mediante nuestro oráculo Airnode de API3. Construya dApps que usen datos ambientales reales, sin intermediario centralizado.

Datos on-chain con el oráculo Airnode

Los datos de ZipCheckup están disponibles on-chain mediante Airnode de API3, un oráculo de primera parte que permite a los contratos inteligentes solicitar puntajes de calidad del agua directamente desde nuestra API, sin intermediarios de terceros.

Endpoint de Airnode Equivalente REST Retorno on-chain
getZipData GET /v1/zip/{zip} data.score (int256)
getZipScore GET /v1/zip/{zip}/score data.score (int256)
getStateData GET /v1/state/{state} data.avgScore (int256)
getRankings GET /v1/rankings data.totalZips (int256)
getContaminantData GET /v1/contaminant/{code} data.code (bytes32)

Cómo funciona

Su contrato inteligente envía una solicitud mediante RRP (Request-Response Protocol). Nuestro Airnode, que corre en un servidor dedicado, recibe la solicitud, llama a la API de ZipCheckup y entrega la respuesta on-chain. Solo paga el gas: sin tarifas de oráculo ni intermediarios.

Estado actual

Airnode está desplegado en la testnet Ethereum Sepolia y disponible para pruebas de integración. El despliegue en mainnet (Ethereum + Polygon) llegará cuando haya demanda de producción. Contáctenos para acceso anticipado.

¿Le interesa construir una dApp con datos de ZipCheckup? Escríbanos: le ayudamos con la integración.

Widget para incrustar

Añada una tarjeta de puntaje de ZipCheckup a cualquier sitio con una sola línea de HTML. No requiere JavaScript.

HTML
<iframe
  src="https://zipcheckup.com/embed/90210"
  width="400"
  height="300"
  frameborder="0"
  title="ZipCheckup Home Safety Score"
></iframe>

Reemplace 90210 por cualquier código postal de EE. UU. El widget es responsive y se adapta a su contenedor. Para más opciones, use el generador de embeds.

Badges & Attribution

Add a ZipCheckup badge to your site. Free, auto-updating, shows live data.

Live Preview

Home Safety Score for ZIP 90210

Full Badge (with score)

Shows the live Home Safety Score for any ZIP code. Replace 90210 with the target ZIP.

HTML
<a href="https://zipcheckup.com/report/90210/" target="_blank" rel="noopener">
  <img src="https://zipcheckup.com/badge/90210.svg"
       alt="Home Safety Score for ZIP 90210" height="32">
</a>

Compact Badge (text only)

A lightweight text link, ideal for footers or sidebars.

HTML
<a href="https://zipcheckup.com"
   style="font-size:12px;color:var(--gray-text600);text-decoration:none;">
  Powered by ZipCheckup
</a>

Markdown

For README files, GitHub repos, and documentation. Replace 90210 with the target ZIP.

Markdown
[![Home Safety Score](https://zipcheckup.com/badge/90210.svg)](https://zipcheckup.com/report/90210/)

Using our API? A "Built with ZipCheckup" link is appreciated but not required under CC BY 4.0.

Datos y licencias

Datos abiertos, metodología transparente y fuentes gubernamentales.

Licencia CC BY 4.0

Todos los datos de ZipCheckup están disponibles bajo la licencia Creative Commons Attribution 4.0. Úselos en proyectos comerciales y no comerciales con atribución.

Más de 49 fuentes gubernamentales

Los datos se compilan de EPA SDWIS, FEMA NFIP, CDC PLACES, Census ACS B25077 (valores de vivienda), DOE, USGS, CPSC y más de 40 agencias federales y estatales adicionales.

Metodología

Nuestra metodología de puntuación está totalmente documentada. Vea la página Datos y metodología para conocer cómo calculamos los puntajes compuestos y calificamos cada factor de riesgo.

Frecuencia de actualización

Los datos se refrescan trimestralmente desde bases de datos gubernamentales. Los registros de infracciones y reclamos de inundación se actualizan a medida que hay nuevos datos federales disponibles.

Plantilla de citación

ZipCheckup. «Reporte de seguridad del hogar para [Código postal]». ZipCheckup.com, 2026. https://zipcheckup.com/zip/[ZIP]. Consultado el [Fecha]. Licencia CC BY 4.0.

Límites de uso y precios

Empiece a construir gratis. Escale cuando lo necesite.

Pro

Pro

Por definir
próximamente
  • 10,000 solicitudes al día
  • Consultas masivas de códigos postales
  • Soporte prioritario
  • Notificaciones por webhook
  • Exportaciones en CSV/GeoJSON
Unirse a la lista de espera
Enterprise

Enterprise

Personalizado
contáctenos
  • Solicitudes ilimitadas
  • Infraestructura dedicada
  • Feeds de datos personalizados
  • Garantía de SLA
  • Opciones de marca blanca
Contáctenos

¿Necesita más? Hablemos.

¿Está construyendo algo interesante con datos de ZipCheckup? ¿Necesita límites de uso más altos o feeds de datos personalizados?