API para obtener tasas de criminalidad por código postal

Necesitas el riesgo de criminalidad por código postal esta semana, no una revisión de GIS. Al final de esta guía, consultarás un endpoint, pasarás un código postal y obtendrás una calificación general de criminalidad más un desglose de tasas de criminalidad violenta, de propiedad y otras que puedes integrar directamente en tu producto.

Qué obtienes de la API de Datos de Criminalidad por Código Postal

La API de Datos de Criminalidad por Código Postal devuelve un objeto JSON para un código postal de EE. UU. dado con:

Calificación general de criminalidad más calificaciones separadas para criminalidad violenta, de propiedad y otras.
Tasas de criminalidad a nivel de categoría (por ejemplo, Asalto, Robo, Hurto, Robo de Vehículo, etc.).
Totales y puntajes por categoría.
Códigos postales cercanos con sus calificaciones.
Códigos postales con población similar y sus calificaciones.

Los casos de uso comunes incluyen superposiciones de búsqueda de propiedades, herramientas de reubicación, filtros de riesgo para servicios de entrega y paneles de seguridad internos. Pasas un código postal y obtienes datos estructurados y consistentes que puedes renderizar de inmediato.

Comenzando en Zyla API Hub

Zyla API Hub te da una cuenta, una clave API y un modelo de suscripción + cuota que funciona en más de 10,000 APIs públicas. Para usar esta API:

Abre la página de la API en Zyla API Hub.
En la página de listado, haz clic en Suscribirse o Iniciar Prueba Gratuita (cuando esté disponible) para obtener tu clave.
Llama al endpoint con Authorization: Bearer YOUR_API_KEY.

Puedes iniciar una prueba de 7 días directamente desde el listado: Iniciar prueba de 7 días en la API de Datos de Criminalidad por Código Postal. Consulta la página de la API para opciones de acceso y precios actuales.

Endpoint que usarás

Esta API expone un único endpoint amigable para desarrolladores.

Nombre: Obtener Tasas de Criminalidad por Código Postal
Método: GET
URL: https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip
Parámetro de consulta requerido: zip (número). Ejemplo: 01370
Auth: Authorization: Bearer YOUR_API_KEY

Prueba rápida con curl

Copia/pega y reemplaza YOUR_API_KEY con tu clave:

curl -s -X GET "https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip?zip=01370" \
-H "Authorization: Bearer YOUR_API_KEY"

Ejemplo de respuesta oficial

{"Overall":{"Zipcode":"01370","Overall Crime Grade":"B","Violent Crime Grade":"C-","Property Crime Grade":"B","Other Crime Grade":"B"},"Crime BreakDown":[{"Violent Crime Rates":{"Assault":"2.759","Robbery":"0.4627","Rape":"0.5506","Murder":"0.0218"},"0":{"Total Violent Crime":"3.795","Total Violent Crime Score":"(C-)"}},{"Property Crime Rates":{"Theft":"8.498","Vehicle Theft":"0.6988","Burglary":"1.563","Arson":"0.0619"},"0":{"Total Property Crime":"10.82","Total Property Crime Score":"(B)"}},{"Other Crime Rates":{"Kidnapping":"0.1303","Drug Crimes":"1.553","Vandalism":"3.749","Identity Theft":"0.4203","Animal Cruelty":"0.0490"},"0":{"Total Other Rate":"5.902","Total Other Score":"(B)"}}],"Crime Rates Nearby":[{"Nearby Zip":"01338, MA","Overall Crime Grade":"B-","Violent Crime Grade":"D","Property Crime Grade":"B-"},{"Nearby Zip":"01340, MA","Overall Crime Grade":"A-","Violent Crime Grade":"A-","Property Crime Grade":"B"},{"Nearby Zip":"01341, MA","Overall Crime Grade":"A","Violent Crime Grade":"C-","Property Crime Grade":"A"},{"Nearby Zip":"01301, MA","Overall Crime Grade":"C+","Violent Crime Grade":"C-","Property Crime Grade":"C"},{"Nearby Zip":"01330, MA","Overall Crime Grade":"A","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Nearby Zip":"01346, MA","Overall Crime Grade":"A","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01339, MA","Overall Crime Grade":"A-","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01342, MA","Overall Crime Grade":"A","Violent Crime Grade":"B+","Property Crime Grade":"A+"},{"Nearby Zip":"01376, MA","Overall Crime Grade":"B-","Violent Crime Grade":"C+","Property Crime Grade":"B-"},{"Nearby Zip":"01337, MA","Overall Crime Grade":"A","Violent Crime Grade":"B-","Property Crime Grade":"A"}],"Similar Population Crime Rates":[{"Similar Zip":"34217, FL","Overall Crime Grade":"A-","Violent Crime Grade":"C+","Property Crime Grade":"C+"},{"Similar Zip":"72046, AR","Overall Crime Grade":"F","Violent Crime Grade":"D-","Property Crime Grade":"D-"},{"Similar Zip":"52778, IA","Overall Crime Grade":"B","Violent Crime Grade":"A-","Property Crime Grade":"A-"},{"Similar Zip":"54126, WI","Overall Crime Grade":"A","Violent Crime Grade":"A+","Property Crime Grade":"A+"},{"Similar Zip":"02715, MA","Overall Crime Grade":"A+","Violent Crime Grade":"A-","Property Crime Grade":"A-"},{"Similar Zip":"67025, KS","Overall Crime Grade":"B-","Violent Crime Grade":"B+","Property Crime Grade":"B+"},{"Sim…

Qué leer de esta carga útil:

General: usa la Calificación General de Criminalidad y las sub-calificaciones para colorear una insignia de código postal o un medidor de riesgo.
Desglose de Criminalidad: lee las tasas por categoría (por ejemplo, Asalto, Hurto) y los totales y puntajes por categoría.
Tasas de Criminalidad Cercanas: ofrece códigos postales alternativos con sus calificaciones.
Tasas de Criminalidad de Población Similar: muestra las calificaciones de códigos postales comparables para contexto.

Nota: las tasas numéricas se devuelven como cadenas. Convierte a números en tu código si necesitas calcular con ellas.

Ejemplo en Python: obtener calificaciones y tasas clave

Este ejemplo llama al mismo endpoint, analiza el JSON y extrae calificaciones y algunos valores de tasas. Reemplaza YOUR_API_KEY con tu clave.

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
ZIP = "01370"

url = "https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip"
resp = requests.get(url, params={"zip": ZIP}, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=20)
resp.raise_for_status()
data = resp.json()

overall = data.get("Overall", {})
grades = {
"zip": overall.get("Zipcode"),
"overall": overall.get("Overall Crime Grade"),
"violent": overall.get("Violent Crime Grade"),
"property": overall.get("Property Crime Grade"),
"other": overall.get("Other Crime Grade")
}

# Recorrer Desglose de Criminalidad para extraer algunas tasas representativas
assault = robbery = theft = None
for section in data.get("Crime BreakDown", []):
if "Violent Crime Rates" in section:
v = section["Violent Crime Rates"]
assault = float(v.get("Assault")) if v.get("Assault") is not None else None
robbery = float(v.get("Robbery")) if v.get("Robbery") is not None else None
if "Property Crime Rates" in section:
p = section["Property Crime Rates"]
theft = float(p.get("Theft")) if p.get("Theft") is not None else None

print("Grades:", grades)
print("Key rates:", {"Assault": assault, "Robbery": robbery, "Theft": theft})

# Lista de códigos postales cercanos (primeros tres)
nearby = data.get("Crime Rates Nearby", [])[:3]
print("Nearby:", nearby)

Notas de implementación que ahorran tiempo

Autenticación: siempre envía Authorization: Bearer YOUR_API_KEY.
Entrada: zip es numérico. Asegúrate de pasar un código postal de 5 dígitos. Si tu interfaz captura ZIP+4, elimina el sufijo.
Análisis: campos como “Asalto”, “Hurto” son cadenas. Convierte a float si es necesario.
Cacheo: almacena en caché por código postal para evitar búsquedas repetidas en la misma sesión. Las calificaciones de criminalidad cambian lentamente en relación con la cadencia de solicitudes, por lo que un caché diario suele ser suficiente.
Alternativas: si un código postal está ausente o devuelve desglose incompleto, muestra la Calificación General de Criminalidad y los códigos postales cercanos como alternativas.
Mapeo de UI: trata las calificaciones (A+ a F) como categorías ordenadas para escalas de color; no asumas una escala numérica lineal a menos que conviertas explícitamente.
Errores: muestra respuestas no 2xx con el mensaje y la entrada de código postal en tus registros. Agrega validación de entrada del lado del cliente para códigos postales de 5 dígitos.

Patrones y casos de uso comunes

Búsqueda de propiedades: muestra una insignia de Calificación General de Criminalidad en las páginas de listado claveadas por el código postal de la propiedad.
Calificación de leads: dirige leads de ventas desde códigos postales de menor riesgo a colas prioritarias.
Logística: filtra ventanas de entrega o agrega alertas para conductores utilizando las calificaciones de Criminalidad Violenta y de Propiedad.
Cotización de seguros: incorpora totales por categoría (por ejemplo, Robo de Vehículo) en modelos de riesgo internos.
Herramientas de reubicación: sugiere códigos postales cercanos con calificaciones más altas como alternativas.

Llamando a la API desde agentes de IA a través de MCP

Si usas clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf), puedes llamar a las APIs de Zyla a través de la puerta de enlace MCP. Apunta tu cliente al endpoint de MCP e incluye tu clave según lo configurado por tu herramienta. Aprende más aquí: MCP.

El mismo endpoint del hub es accesible a través de la puerta de enlace, por lo que el único cambio es cómo tu cliente enruta la solicitud y adjunta la Autorización. Consulta la documentación de tu cliente MCP para la configuración de la herramienta y el enrutamiento de solicitudes.

Lista de verificación de cableado de extremo a extremo

Obtén una clave API de la página de listado en Zyla API Hub.
Valida y normaliza el código postal a una cadena numérica de 5 dígitos.
GET https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip con zip y token Bearer.
Renderiza la Calificación General de Criminalidad de inmediato; carga de manera perezosa desglose detallado si tu interfaz lo necesita.
Ofrece alternativas cercanas utilizando Tasas de Criminalidad Cercanas si la calificación está por debajo de tu umbral.
Almacena en caché las respuestas por código postal para reducir la latencia y las llamadas.

FAQ

¿Qué parámetro requiere el endpoint?
Pasa zip como un número en la cadena de consulta, por ejemplo, zip=01370.

¿Cómo me autentico?
Envía Authorization: Bearer YOUR_API_KEY en los encabezados de la solicitud.

¿Qué devuelve la API?
Un objeto JSON que contiene calificaciones generales y por categoría de criminalidad, tasas detalladas, calificaciones de códigos postales cercanos y calificaciones de códigos postales de población similar.

¿Las tasas numéricas son números o cadenas?
Son cadenas en la carga útil; conviértelas a float en tu código cuando sea necesario.

¿Cómo se maneja la facturación?
Zyla utiliza un modelo de suscripción + cuota (no pago por llamada). Consulta la página de la API para opciones de acceso actuales. Puedes iniciar una prueba de 7 días en la página de listado.

¿Listo para integrar? Crea tu cuenta en Zyla API Hub, obtén tu clave y lanza tu función de criminalidad por código postal utilizando el endpoint del listado. Comienza aquí: API de Datos de Criminalidad por Código Postal.

Respuesta oficial de la API

{"Overall":{"Zipcode":"01370","Overall Crime Grade":"B","Violent Crime Grade":"C-","Property Crime Grade":"B","Other Crime Grade":"B"},"Crime BreakDown":[{"Violent Crime Rates":{"Assault":"2.759","Robbery":"0.4627","Rape":"0.5506","Murder":"0.0218"},"0":{"Total Violent Crime":"3.795","Total Violent Crime Score":"(C-)"}},{"Property Crime Rates":{"Theft":"8.498","Vehicle Theft":"0.6988","Burglary":"1.563","Arson":"0.0619"},"0":{"Total Property Crime":"10.82","Total Property Crime Score":"(B)"}},{"Other Crime Rates":{"Kidnapping":"0.1303","Drug Crimes":"1.553","Vandalism":"3.749","Identity Theft":"0.4203","Animal Cruelty":"0.0490"},"0":{"Total Other Rate":"5.902","Total Other Score":"(B)"}}],"Crime Rates Nearby":[{"Nearby Zip":"01338, MA","Overall Crime Grade":"B-","Violent Crime Grade":"D","Property Crime Grade":"B-"},{"Nearby Zip":"01340, MA","Overall Crime Grade":"A-","Violent Crime Grade":"A-","Property Crime Grade":"B"},{"Nearby Zip":"01341, MA","Overall Crime Grade":"A","Violent Crime Grade":"C-","Property Crime Grade":"A"},{"Nearby Zip":"01301, MA","Overall Crime Grade":"C+","Violent Crime Grade":"C-","Property Crime Grade":"C"},{"Nearby Zip":"01330, MA","Overall Crime Grade":"A","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Nearby Zip":"01346, MA","Overall Crime Grade":"A","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01339, MA","Overall Crime Grade":"A-","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01342, MA","Overall Crime Grade":"A","Violent Crime Grade":"B+","Property Crime Grade":"A+"},{"Nearby Zip":"01376, MA","Overall Crime Grade":"B-","Violent Crime Grade":"C+","Property Crime Grade":"B-"},{"Nearby Zip":"01337, MA","Overall Crime Grade":"A","Violent Crime Grade":"B-","Property Crime Grade":"A"}],"Similar Population Crime Rates":[{"Similar Zip":"34217, FL","Overall Crime Grade":"A-","Violent Crime Grade":"C+","Property Crime Grade":"C+"},{"Similar Zip":"72046, AR","Overall Crime Grade":"F","Violent Crime Grade":"D-","Property Crime Grade":"D-"},{"Similar Zip":"52778, IA","Overall Crime Grade":"B","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Similar Zip":"54126, WI","Overall Crime Grade":"A","Violent Crime Grade":"A+","Property Crime Grade":"A+"},{"Similar Zip":"02715, MA","Overall Crime Grade":"A+","Violent Crime Grade":"A-","Property Crime Grade":"A-"},{"Similar Zip":"67025, KS","Overall Crime Grade":"B-","Violent Crime Grade":"B+","Property Crime Grade":"B+"},{"Sim…

Respuesta oficial de la API

{"Overall":{"Zipcode":"01370","Overall Crime Grade":"B","Violent Crime Grade":"C-","Property Crime Grade":"B","Other Crime Grade":"B"},"Crime BreakDown":[{"Violent Crime Rates":{"Assault":"2.759","Robbery":"0.4627","Rape":"0.5506","Murder":"0.0218"},"0":{"Total Violent Crime":"3.795","Total Violent Crime Score":"(C-)"}},{"Property Crime Rates":{"Theft":"8.498","Vehicle Theft":"0.6988","Burglary":"1.563","Arson":"0.0619"},"0":{"Total Property Crime":"10.82","Total Property Crime Score":"(B)"}},{"Other Crime Rates":{"Kidnapping":"0.1303","Drug Crimes":"1.553","Vandalism":"3.749","Identity Theft":"0.4203","Animal Cruelty":"0.0490"},"0":{"Total Other Rate":"5.902","Total Other Score":"(B)"}}],"Crime Rates Nearby":[{"Nearby Zip":"01338, MA","Overall Crime Grade":"B-","Violent Crime Grade":"D","Property Crime Grade":"B-"},{"Nearby Zip":"01340, MA","Overall Crime Grade":"A-","Violent Crime Grade":"A-","Property Crime Grade":"B"},{"Nearby Zip":"01341, MA","Overall Crime Grade":"A","Violent Crime Grade":"C-","Property Crime Grade":"A"},{"Nearby Zip":"01301, MA","Overall Crime Grade":"C+","Violent Crime Grade":"C-","Property Crime Grade":"C"},{"Nearby Zip":"01330, MA","Overall Crime Grade":"A","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Nearby Zip":"01346, MA","Overall Crime Grade":"A","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01339, MA","Overall Crime Grade":"A-","Violent Crime Grade":"C","Property Crime Grade":"A"},{"Nearby Zip":"01342, MA","Overall Crime Grade":"A","Violent Crime Grade":"B+","Property Crime Grade":"A+"},{"Nearby Zip":"01376, MA","Overall Crime Grade":"B-","Violent Crime Grade":"C+","Property Crime Grade":"B-"},{"Nearby Zip":"01337, MA","Overall Crime Grade":"A","Violent Crime Grade":"B-","Property Crime Grade":"A"}],"Similar Population Crime Rates":[{"Similar Zip":"34217, FL","Overall Crime Grade":"A-","Violent Crime Grade":"C+","Property Crime Grade":"C+"},{"Similar Zip":"72046, AR","Overall Crime Grade":"F","Violent Crime Grade":"D-","Property Crime Grade":"D-"},{"Similar Zip":"52778, IA","Overall Crime Grade":"B","Violent Crime Grade":"A-","Property Crime Grade":"A"},{"Similar Zip":"54126, WI","Overall Crime Grade":"A","Violent Crime Grade":"A+","Property Crime Grade":"A+"},{"Similar Zip":"02715, MA","Overall Crime Grade":"A+","Violent Crime Grade":"A-","Property Crime Grade":"A-"},{"Similar Zip":"67025, KS","Overall Crime Grade":"B-","Violent Crime Grade":"B+","Property Crime Grade":"B+"},{"Sim…