Cómo usar la API de datos de crimen por código postal

Necesitas mostrar las calificaciones de crimen y desgloses de categorías para un código postal de EE. UU. en tu aplicación esta semana. Al final de esta guía, podrás solicitar calificaciones y tasas de crimen para un código postal, analizar la respuesta y enviarla con una pequeña integración lista para producción.

Lo que esta API te ofrece

La API de datos de crimen por código postal devuelve una calificación general de crimen para un código postal y un desglose de categorías de crimen violento, de propiedad y otras, además de comparaciones con códigos postales cercanos y códigos postales de población similar. Está diseñada para aplicaciones como búsqueda de bienes raíces, planificación logística, evaluación de riesgos de seguros y paneles locales donde se requiere un perfil rápido de crimen por código postal.

Esta API está disponible en Zyla API Hub, un mercado con más de 10,000 APIs públicas bajo una cuenta, una clave API y un modelo de suscripción.

Comenzando en Zyla API Hub

Para usar esta API:

1. Abre la página de la API en Zyla API Hub y suscríbete.
2. Copia tu clave API desde el panel de control.
3. Haz la llamada al endpoint con Authorization: Bearer YOUR_API_KEY.

Puedes comenzar con una prueba de 7 días en la página del artículo. Consulta la página de la API para conocer las opciones de acceso y precios actuales. La facturación es por suscripción + cuota, no por llamada.

Inicia la prueba de 7 días en la API de datos de crimen por código postal

Endpoint y solicitud

La API de datos de crimen por código postal expone un endpoint clave para obtener datos de crimen para un código postal:

• Obtener tasas de crimen 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): código postal a analizar (ejemplo: 01370)

Ejemplo oficial de cURL

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…

Campos clave que típicamente verás:

• Overall.Zipcode: código postal de la consulta.
• Overall.Overall Crime Grade: calificación de una sola letra (por ejemplo, B).
• Overall.Violent Crime Grade, Property Crime Grade, Other Crime Grade: calificaciones por categoría.
• Crime BreakDown: tasas y totales específicos de la categoría (por ejemplo, Asalto, Robo, Vandalismo) y puntuaciones agregadas.
• Crime Rates Nearby: códigos postales cercanos con sus calificaciones para comparar contexto.
• Similar Population Crime Rates: códigos postales con población similar y sus calificaciones.

Notas:

• Los nombres de los campos incluyen espacios (por ejemplo, “Overall Crime Grade”). Al analizar JSON, accede a ellos tal como están.
• Las unidades para las tasas numéricas son métricas por población según lo proporcionado por el servicio. Muestra los datos tal como se devuelven a menos que los transformes de manera consistente en tu interfaz de usuario.
• Si tu carga de trabajo consulta los mismos códigos postales repetidamente, agrega almacenamiento en caché del lado del cliente para reducir llamadas duplicadas y latencia.

Ejemplo en Python: obtener un código postal y extraer calificaciones

Este ejemplo llama al endpoint, lee las calificaciones generales y por categoría, y resume los códigos postales cercanos. Reemplaza YOUR_API_KEY con tu clave real.

import os
import requests

API_KEY = os.getenv("Zyla_API_Key", "YOUR_API_KEY")
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=15)
resp.raise_for_status()
data = resp.json()

overall = data.get("Overall", {})
overall_grade = overall.get("Overall Crime Grade")
violent_grade = overall.get("Violent Crime Grade")
property_grade = overall.get("Property Crime Grade")
other_grade = overall.get("Other Crime Grade")

print(f"ZIP {overall.get('Zipcode')}: overall {overall_grade}, "
f"violent {violent_grade}, property {property_grade}, other {other_grade}")

# Ejemplo: extraer la tasa de Asalto y el Total de Crimen de Propiedad si están presentes
breakdown = data.get("Crime BreakDown", [])
for section in breakdown:
if "Violent Crime Rates" in section:
assault = section["Violent Crime Rates"].get("Assault")
print(f"Tasa de Asalto: {assault}")
if "Property Crime Rates" in section:
total_prop = section.get("0", {}).get("Total Property Crime")
print(f"Total Crimen de Propiedad: {total_prop}")

# Vista previa de calificaciones de códigos postales cercanos
nearby = data.get("Crime Rates Nearby", [])
for n in nearby[:3]:
print(f"Cercano {n.get('Nearby Zip')}: overall {n.get('Overall Crime Grade')}")

Detalles de implementación que ahorran tiempo

• Autenticación: usa Authorization: Bearer YOUR_API_KEY en cada solicitud.
• Manejo de errores: trata las respuestas no 2xx como transitorias o entradas inválidas (por ejemplo, código postal mal formado o no soportado). Registra el código de estado y el cuerpo de la respuesta para solucionar problemas.
• Timeouts: establece un tiempo de espera del cliente (10–15 segundos es un valor predeterminado práctico) y vuelve a intentar GETs idempotentes en fallas de red.
• Almacenamiento en caché: almacena en caché por código postal para tu ventana de caso de uso (por ejemplo, horas a días). Agrega un comportamiento de stale-while-revalidate en trabajos en segundo plano.
• Consejos de UI:
  • Las calificaciones son basadas en letras; proporciona una leyenda para evitar ambigüedades (por ejemplo, A mejor a F peor).
  • Al mostrar totales por categoría (por ejemplo, “Total Crimen de Propiedad”), incluye la puntuación de la categoría si está presente (por ejemplo, “(B)”).
  • Para contexto, agrega una vista de comparación de “códigos postales cercanos” usando Crime Rates Nearby.

Casos de uso prácticos que puedes implementar ahora

• Búsqueda de propiedades: muestra una pastilla de calificación general por cada tarjeta de listado usando el código postal de la propiedad; expande a un desglose por categoría en la vista de detalle.
• Herramientas de reubicación: para un código postal elegido, obtén la calificación y los códigos postales cercanos para recomendar vecindarios más seguros o comparables.
• Operaciones de última milla: calcula una puntuación de riesgo por código postal para la planificación de rutas y ventanas de tiempo de entrega.
• Portales de evaluación de inquilinos: agrega un panel de riesgo contextual por código postal a las solicitudes de alquiler.
• Pre-cotización de seguros: muestra indicios de riesgo de ubicación antes de recopilar formularios con mucha información personal.

Llama a la API desde agentes de IA con MCP

Puedes invocar este mismo endpoint desde agentes de IA y IDEs compatibles a través del protocolo de contexto de modelo (MCP) de Zyla. MCP estandariza el acceso a la API para herramientas como Claude Code, Cursor y Windsurf. Apunta tu cliente al endpoint de MCP, autoriza con tu clave API de Zyla y llama a la herramienta que emite un GET a la URL de la API de datos de crimen por código postal con el parámetro zip.

Documentos y detalles de conexión: MCP. Usa la misma Authorization: Bearer YOUR_API_KEY y preserva la URL de solicitud exacta y los parámetros descritos anteriormente.

Lista de verificación operativa

• Entradas: valida el código postal como una cadena numérica de 5 dígitos; rechaza o sanitiza caracteres no numéricos antes de llamar.
• Observabilidad: registra el ID de solicitud, código postal, código de estado y metadatos mínimos de respuesta (por ejemplo, calificación general) para paneles de soporte.
• Backoff: en errores transitorios o respuestas de tasa, aplica un backoff exponencial y jitter; muestra un mensaje de respaldo en la UI.
• Seguridad: mantén la clave API en secretos del lado del servidor; nunca la expongas en el código del lado del cliente.
• Actualización de datos: si sincronizas periódicamente códigos postales populares, ejecuta un trabajo programado que caliente tu caché para reducir la latencia percibida.

Resumen del flujo de extremo a extremo

1. El usuario selecciona un código postal o lo infieres de un geocodificador de direcciones.
2. Tu backend llama a GET https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip con zip=XXXXX y Authorization: Bearer YOUR_API_KEY.
3. Analiza los campos JSON que necesitas:
   • Calificaciones generales para la UI de nivel superior.
   • Desglose de crimen para tooltips y paneles de detalle.
   • Códigos postales cercanos para recomendaciones.
4. Almacena en caché la respuesta indexada por código postal; expira según tu programación.
5. Renderiza calificaciones y tasas en tu UI; opcionalmente agrega enlaces para comparar códigos postales cercanos.

Preguntas frecuentes

¿Qué parámetro es requerido?
Pasa zip como un número en la cadena de consulta (ejemplo: zip=01370).

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

¿Puedo obtener comparaciones de códigos postales cercanos?
Sí. La respuesta incluye Crime Rates Nearby con códigos postales cercanos y sus calificaciones.

¿Cuál es el modelo de precios?
Las APIs de Zyla utilizan suscripción + cuota. Consulta la página de la API para conocer las opciones de acceso actuales; una prueba de 7 días comienza en la página del artículo.

¿Puedo llamar a esto desde un agente de IA?
Sí, a través de la puerta de enlace MCP de Zyla en herramientas compatibles. Usa el mismo encabezado de autorización y la URL y el parámetro zip documentados.

¿Listo para integrar? Crea tu cuenta en Zyla API Hub, obtén tu clave API y comienza tu prueba aquí: API de datos de crimen por código postal. Una cuenta, una clave, miles de APIs que puedes implementar esta semana.

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…