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.
GET https://zipcheckup.com/api/v1/zip/90210
{
"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.
<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.
Full Badge (with score)
Shows the live Home Safety Score for any ZIP code. Replace 90210 with the target ZIP.
<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.
<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.
[](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
Límites de uso y precios
Empiece a construir gratis. Escale cuando lo necesite.
Inicial
- 100 solicitudes al día
- Todos los endpoints incluidos
- Respuestas en JSON
- Sin clave de API
- Licencia de datos CC BY 4.0
Pro
- 10,000 solicitudes al día
- Consultas masivas de códigos postales
- Soporte prioritario
- Notificaciones por webhook
- Exportaciones en CSV/GeoJSON
Enterprise
- Solicitudes ilimitadas
- Infraestructura dedicada
- Feeds de datos personalizados
- Garantía de SLA
- Opciones de marca blanca
Tutoriales y guías
Guías paso a paso para sacar el máximo provecho de los datos de ZipCheckup.
-
Añada ZipCheckup a su flujo de trabajo en Zapier/Make
Automatice consultas de seguridad del hogar en sus flujos no-code actuales con nuestra API REST.
-
Incruste un widget de calidad del agua en su sitio de noticias
Añada una tarjeta de puntaje interactiva a cualquier sitio con una sola línea de código — configuración en 5 min.
-
Python: analice tendencias de calidad del agua
Obtenga, analice y visualice datos de calidad del agua con pandas y matplotlib.
¿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?
Hable con el equipo de API