Necesitas mostrar calificaciones de criminalidad y un desglose por delito para un código postal de EE. UU. dado, integrarlo en tu aplicación esta semana y seguir adelante. Al final de esta guía, obtendrás una calificación general de criminalidad más componentes de delitos violentos, de propiedad y otros para cualquier código postal, y lo podrás incluir en un panel, página de listado o modelo de riesgo con una sola solicitud GET.
Lo que puedes construir con un solo código postal
La API de Datos de Criminalidad por Código Postal devuelve un informe JSON compacto para el código postal que envías. Obtendrás:
- Calificación General de Criminalidad (calificación en letras)
- Desglose de delitos violentos, de propiedad y otros con totales y tasas por categoría
- Comparaciones de códigos postales cercanos y comparaciones de códigos postales de población similar
Los equipos integran esto en listados de bienes raíces, herramientas de reubicación, prototipos de suscripción y paneles de datos de la ciudad. Envías un código postal, obtienes una puntuación y un desglose que puedes renderizar de inmediato.
Comenzando en Zyla API Hub
Abre el listado de la API en Zyla API Hub y suscríbete para obtener una clave de API. Zyla utiliza un modelo de suscripción + cuota (no pago por llamada). Para tu primera API, puedes comenzar una prueba de 7 días o 50 solicitudes, dependiendo de la disponibilidad; consulta la página de la API para conocer las opciones de acceso y precios actuales.
- Ve a la página de la API: Comienza la prueba de 7 días en la API de Datos de Criminalidad por Código Postal
- Haz clic en Suscribirse o Comenzar Prueba Gratuita cuando esté disponible.
- Copia tu clave de API desde tu cuenta. La autenticación es un encabezado HTTP: Authorization: Bearer YOUR_API_KEY.
Zyla API Hub alberga más de 10,000 APIs públicas en finanzas, enriquecimiento, IA, geolocalización, comercio electrónico y utilidades. Navega por el catálogo en zylalabs.com y reutiliza tu misma clave en diferentes listados.
Endpoint que usarás
Esta API tiene una sola función: devolver calificaciones y tasas de criminalidad para un código postal dado.
- Endpoint: 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
Ejemplo de cURL (copiar/pegar)
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"Respuesta de muestra 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…Lo que los desarrolladores suelen extraer:
Overall.Overall Crime Gradepara una insignia de una sola letra (A+ a F).Overall.Violent Crime Grade,Overall.Property Crime Grade,Overall.Other Crime Gradepara sub-puntuaciones.- Totales del array
Crime BreakDown(por ejemplo,Total Violent Crime,Total Property Crime,Total "Other" Rate). - Lista de códigos postales cercanos del
Crime Rates Nearbypara comparaciones de contexto.
Ejemplo en Python: obtener y normalizar las calificaciones
Este script mínimo llama al mismo endpoint, analiza las calificaciones y aplana los totales para su renderización. Almacena YOUR_API_KEY en una variable de entorno antes de ejecutar.
import os
import requests
API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY") # reemplazar en pruebas locales
ZIP = "01370"
url = "https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip"
params = {"zip": ZIP}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(url, params=params, headers=headers, 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"),
}
# Extraer totales de Crime BreakDown
totals = {}
for section in data.get("Crime BreakDown", []):
# Cada sección tiene una clave "0" con totales; mantener lo que esté disponible
totals.update(section.get("0", {}))
nearby = [
{
"zip": item.get("Nearby Zip"),
"overall": item.get("Overall Crime Grade"),
"violent": item.get("Violent Crime Grade"),
"property": item.get("Property Crime Grade"),
}
for item in data.get("Crime Rates Nearby", [])
]
print("Grades:", grades)
print("Totals:", totals)
print("Nearby (first 3):", nearby[:3])Notas de implementación que ahorran tiempo
- Autenticación: cada solicitud debe incluir Authorization: Bearer YOUR_API_KEY.
- Tipo de parámetro: el parámetro
zipes numérico en el listado. Si aceptas entrada de usuario con ceros a la izquierda, normaliza a un número o pasa los dígitos exactos que el usuario ingresó. - Cacheo: las calificaciones de criminalidad no cambian minuto a minuto. Cachea por código postal para reducir llamadas repetidas en páginas de alto tráfico.
- Renderización: las calificaciones son cadenas de letras como A, A-, B, …, F. Mantén la cadena original; no conviertas a números a menos que tu modelo lo necesite.
- Desglose: la respuesta incluye totales bajo una clave llamada
"0"dentro de cada objeto de desglose. Extrae esos para resúmenes rápidos. - Comparaciones: el array
Crime Rates Nearbyes ideal para una lista lateral de códigos postales vecinos con insignias simples. Lo mismo para comparaciones de población similar.
Casos de uso en el mundo real
- Páginas de listados de propiedades: muestra “Calificación General de Criminalidad” y expande un panel de detalles con totales de delitos violentos, de propiedad y otros.
- Calculadoras de reubicación: ingresa un código postal y muestra códigos postales cercanos con mejores o peores calificaciones de
Crime Rates Nearby. - Planificación de rutas y entregas: marca depósitos o áreas de servicio con calificaciones más bajas y dirige pasos de mitigación.
- Prototipos de suscripción: mapea el código postal de un prospecto a un grupo de riesgo usando la calificación general y el total violento.
- Paneles cívicos: agrega múltiples resultados de códigos postales en un panel municipal y resalta los valores atípicos.
Llamando a la API desde agentes de IA a través de MCP
Si automatizas tareas con clientes compatibles con MCP (por ejemplo, Claude Code, Cursor, Windsurf), puedes exponer este mismo endpoint a tu agente. Configura tu cliente para usar el endpoint MCP de Zyla e incluye tu clave de API de Zyla. El agente realizará la misma solicitud GET, con el encabezado de Autorización, y devolverá el JSON que has visto arriba.
- Endpoint MCP: MCP
- Manejo de claves: reutiliza tu clave de API de Zyla; escópala a las variables de entorno de tu agente.
- Herramientas: haz que tu agente acepte un argumento de código postal y mapea eso al parámetro de consulta
zipen la URL del hub.
Esto mantiene tus solicitudes limpias y permite que tu agente recupere calificaciones de criminalidad bajo demanda durante una sesión de codificación o enriquecimiento de datos.
Referencia rápida
- Endpoint base del hub: https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip
- Método: GET
- Parámetro requerido: zip (número)
- Encabezado de autenticación: Authorization: Bearer YOUR_API_KEY
- Campos de respuesta que probablemente usarás: Calificaciones generales, totales de Crime BreakDown, códigos postales cercanos
Navega por más categorías o combina esto con mapeo, geocodificación o demografía en Zyla API Hub usando la misma clave y modelo de suscripción.
FAQ
¿Qué formatos de código postal son aceptados?
Envía el código postal numérico como el parámetro de consulta zip (por ejemplo, 01370). Si tu aplicación recopila ZIP+4, elimina la extensión y envía el código postal de 5 dígitos.
¿Cómo me autentico?
Incluye el encabezado Authorization: Bearer YOUR_API_KEY en cada solicitud.
¿Puedo hacer solicitudes por lotes?
El endpoint listado acepta un código postal por llamada. Para procesamiento en masa, recorre los códigos postales con concurrencia básica y almacena en caché los resultados.
¿Qué representan las calificaciones?
Las calificaciones en letras resumen los niveles de criminalidad por categoría. Usa la “Calificación General de Criminalidad” para una insignia única y las calificaciones por categoría para detalles. La respuesta también incluye cadenas numéricas para varias tasas y totales.
¿Hay un plan gratuito?
Zyla utiliza suscripción + cuota. Para tu primera API, puedes comenzar una prueba de 7 días o 50 solicitudes cuando esté disponible. Consulta la página de la API para conocer las opciones de acceso y precios actuales.
¿Listo para enviar esto? Suscríbete y obtén tu clave en el listado: Comienza la prueba de 7 días en la API de Datos de Criminalidad por Código Postal. Usa la misma cuenta y clave en miles de otras APIs en Zyla.
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…
