Você precisa exibir notas de criminalidade e uma divisão por ofensa para um determinado CEP dos EUA, integrá-lo ao seu aplicativo esta semana e seguir em frente. Ao final deste guia, você obterá uma nota geral de criminalidade, além de componentes violentos/propriedade/outros para qualquer CEP, e poderá inseri-lo em um painel, página de listagem ou modelo de risco com uma única solicitação GET.
O que você pode construir com um único CEP
A API de Dados de Criminalidade por CEP retorna um relatório JSON compacto para o CEP que você passar. Você receberá:
- Nota Geral de Criminalidade (nota em letras)
- Divisões para crimes violentos, de propriedade e outros, com totais e taxas por categoria
- Comparações de CEPs próximos e comparações de CEPs com populações semelhantes
As equipes conectam isso a listagens de imóveis, ferramentas de relocação, protótipos de subscrição e painéis de dados da cidade. Você passa um CEP, recebe uma pontuação e uma divisão que pode renderizar imediatamente.
Começando no Zyla API Hub
Abra a listagem da API no Zyla API Hub e assine para obter uma chave de API. A Zyla usa um modelo de assinatura + cota (não é pago por chamada). Para sua primeira API, você pode iniciar um teste de 7 dias ou 50 solicitações, dependendo da disponibilidade—verifique a página da API para opções de acesso e preços atuais.
- Vá para a página da API: Iniciar teste de 7 dias na API de Dados de Criminalidade por CEP
- Clique em Assinar ou Iniciar Teste Gratuito quando disponível.
- Copie sua chave de API da sua conta. A autenticação é um cabeçalho HTTP: Authorization: Bearer YOUR_API_KEY.
O Zyla API Hub hospeda mais de 10.000 APIs públicas em finanças, enriquecimento, IA, geolocalização, e‑commerce e utilidades. Navegue pelo catálogo em zylalabs.com e reutilize sua mesma chave em várias listagens.
Endpoint que você usará
Esta API tem uma função: retornar notas e taxas de criminalidade para um determinado CEP.
- Endpoint: Obter Taxas de Criminalidade por CEP
- Método: GET
- URL: https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip
- Parâmetro de consulta obrigatório: zip (número). Exemplo: 01370
exemplo cURL (copiar/colar)
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"Resposta de exemplo 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…O que os desenvolvedores geralmente extraem:
Overall.Overall Crime Gradepara um distintivo de uma letra (A+ a F).Overall.Violent Crime Grade,Overall.Property Crime Grade,Overall.Other Crime Gradepara subnotas.- Totais do array
Crime BreakDown(por exemplo,Total Violent Crime,Total Property Crime,Total "Other" Rate). - Lista de CEPs próximos do
Crime Rates Nearbypara comparações de contexto.
Exemplo em Python: buscar e normalizar as notas
Este script mínimo chama o mesmo endpoint, analisa as notas e achata os totais para renderização. Armazene YOUR_API_KEY em uma variável de ambiente antes de executar.
import os
import requests
API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY") # substitua na testagem local
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"),
}
# Extrair totais do Crime BreakDown
totals = {}
for section in data.get("Crime BreakDown", []):
# Cada seção tem uma chave "0" com totais; mantenha o que estiver disponível
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 implementação que economizam tempo
- Autenticação: cada solicitação deve incluir Authorization: Bearer YOUR_API_KEY.
- Tipo de parâmetro: o parâmetro
zipé numérico na listagem. Se você aceitar entrada do usuário com zeros à esquerda, normalize para um numérico ou passe os dígitos exatos que o usuário inseriu. - Cache: notas de criminalidade não mudam minuto a minuto. Armazene em cache por CEP para reduzir chamadas repetidas em páginas de alto tráfego.
- Renderização: as notas são strings de letras como A, A-, B, …, F. Mantenha a string original; não force para números, a menos que seu modelo precise disso.
- Divisões: a resposta inclui totais sob uma chave chamada
"0"dentro de cada objeto de divisão. Extraia esses dados para resumos rápidos. - Comparações: o array
Crime Rates Nearbyé ideal para uma lista lateral de CEPs vizinhos com distintivos simples. O mesmo vale para comparações de populações semelhantes.
Casos de uso do mundo real
- Páginas de listagem de propriedades: mostre a “Nota Geral de Criminalidade” e expanda uma gaveta de detalhes com totais de crimes violentos/propriedade/outros.
- Calculadoras de relocação: insira um CEP e mostre CEPs próximos com notas melhores ou piores do
Crime Rates Nearby. - Planejamento de rotas e entregas: sinalize depósitos ou áreas de serviço com notas mais baixas e direcione etapas de mitigação.
- Protótipos de subscrição: mapeie o CEP de um prospecto para um bucket de risco usando a nota geral e o total violento.
- Painéis cívicos: agregue resultados de múltiplos CEPs em um painel municipal e destaque outliers.
Chamando a API de agentes de IA via MCP
Se você automatiza tarefas com clientes compatíveis com MCP (por exemplo, Claude Code, Cursor, Windsurf), pode expor este mesmo endpoint ao seu agente. Configure seu cliente para usar o endpoint MCP da Zyla e inclua sua chave de API da Zyla. O agente realizará a mesma solicitação GET, com o cabeçalho de Autorização, e retornará o JSON que você viu acima.
- Endpoint MCP: MCP
- Gerenciamento de chave: reutilize sua chave de API da Zyla; limite-a às variáveis de ambiente do seu agente.
- Ferramentas: faça seu agente aceitar um argumento de CEP e mapeie-o para o parâmetro de consulta
zipna URL do hub.
Isso mantém seus prompts limpos e permite que seu agente recupere notas de criminalidade sob demanda durante uma sessão de codificação ou enriquecimento de dados.
Referência rápida
- Endpoint base do hub: https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip
- Método: GET
- Parâmetro obrigatório: zip (número)
- Cabeçalho de autenticação: Authorization: Bearer YOUR_API_KEY
- Campos de resposta que você provavelmente usará: Notas gerais, totais do Crime BreakDown, CEPs próximos
Navegue por mais categorias ou combine isso com mapeamento, geocodificação ou demografia em Zyla API Hub usando a mesma chave e modelo de assinatura.
FAQ
Quais formatos de CEP são aceitos?
Passe o código postal numérico como o parâmetro de consulta zip (por exemplo, 01370). Se seu aplicativo coletar CEP+4, remova a extensão e envie o CEP de 5 dígitos.
Como faço para autenticar?
Inclua o cabeçalho Authorization: Bearer YOUR_API_KEY em cada solicitação.
Posso fazer solicitações em lote?
O endpoint listado aceita um CEP por chamada. Para processamento em massa, faça um loop sobre os CEPs com concorrência básica e armazene os resultados em cache.
O que as notas representam?
Notas em letras resumem os níveis de criminalidade por categoria. Use a “Nota Geral de Criminalidade” para um distintivo único e as notas de categoria para detalhes. A resposta também inclui strings numéricas para várias taxas e totais.
Há um plano gratuito?
A Zyla usa assinatura + cota. Para sua primeira API, você pode iniciar um teste de 7 dias ou 50 solicitações quando disponível. Verifique a página da API para opções de acesso e preços atuais.
Pronto para enviar isso? Assine e obtenha sua chave na listagem: Iniciar teste de 7 dias na API de Dados de Criminalidade por CEP. Use a mesma conta e chave em milhares de outras APIs na Zyla.
Resposta oficial da 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…
