Você precisa mostrar as classificações de crime e as divisões de categorias para um determinado código postal dos EUA em seu aplicativo esta semana. Ao final deste guia, você será capaz de solicitar classificações e taxas de crime para um código postal, analisar a resposta e implementá-la com uma pequena integração pronta para produção.
O que esta API oferece
A API de Dados de Crime por Código Postal retorna uma classificação geral de crime para um código postal e uma divisão de categorias de crime violento, patrimonial e outros crimes, além de comparações com códigos postais próximos e códigos postais de população semelhante. É projetada para aplicativos como busca de imóveis, planejamento logístico, triagem de risco de seguros e painéis locais onde um perfil rápido de crime por código postal é necessário.
Esta API está disponível no Zyla API Hub, um marketplace com mais de 10.000 APIs públicas sob uma conta, uma chave de API e um modelo de assinatura.
Começando no Zyla API Hub
Para usar esta API:
- Abra a página da API no Zyla API Hub e inscreva-se.
- Copie sua chave de API do painel.
- Chame o endpoint com Authorization: Bearer YOUR_API_KEY.
Você pode começar com um teste de 7 dias na página do item. Verifique a página da API para opções de acesso e preços atuais. A cobrança é por assinatura + cota, não por chamada.
Inicie o teste de 7 dias na API de Dados de Crime por Código Postal
Endpoint e solicitação
A API de Dados de Crime por Código Postal expõe um endpoint chave para buscar dados de crime para um código postal:
- Obter Taxas de Crime 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 necessário:
- zip (número): código postal a ser analisado (exemplo: 01370)
Exemplo 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"Exemplo de resposta 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-chave que você normalmente verá:
- Overall.Zipcode: código postal da consulta.
- Overall.Overall Crime Grade: classificação de letra única (ex: B).
- Overall.Violent Crime Grade, Property Crime Grade, Other Crime Grade: classificações de categoria.
- Crime BreakDown: taxas e totais específicos de categoria (ex: Assault, Theft, Vandalism) e pontuações agregadas.
- Crime Rates Nearby: códigos postais próximos com suas classificações para comparar contexto.
- Similar Population Crime Rates: códigos postais com população semelhante e suas classificações.
Notas:
- Nomes de campos incluem espaços (ex: “Overall Crime Grade”). Ao analisar JSON, acesse-os como estão.
- Unidades para as taxas numéricas são métricas por população conforme fornecido pelo serviço. Exiba-as como retornadas, a menos que você transforme consistentemente em sua interface.
- Se sua carga de trabalho consultar os mesmos códigos postais repetidamente, adicione cache do lado do cliente para cortar chamadas duplicadas e latência.
Exemplo em Python: buscar um código postal e extrair classificações
Este exemplo chama o endpoint, lê as classificações gerais e de categoria e resume os códigos postais próximos. Substitua YOUR_API_KEY pela sua chave 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}")
# Exemplo: extrair taxa de Assault e Total Property Crime se presente
breakdown = data.get("Crime BreakDown", [])
for section in breakdown:
if "Violent Crime Rates" in section:
assault = section["Violent Crime Rates"].get("Assault")
print(f"Assault rate: {assault}")
if "Property Crime Rates" in section:
total_prop = section.get("0", {}).get("Total Property Crime")
print(f"Total Property Crime: {total_prop}")
# Prévia das classificações de códigos postais próximos
nearby = data.get("Crime Rates Nearby", [])
for n in nearby[:3]:
print(f"Nearby {n.get('Nearby Zip')}: overall {n.get('Overall Crime Grade')}")Detalhes de implementação que economizam tempo
- Autenticação: use Authorization: Bearer YOUR_API_KEY em cada solicitação.
- Tratamento de erros: trate respostas não-2xx como transientes ou entrada inválida (ex: código postal malformado ou não suportado). Registre o código de status e o corpo da resposta para solução de problemas.
- Timeouts: defina um timeout do cliente (10–15 segundos é um padrão prático) e tente GETs idempotentes em falhas de rede.
- Cache: faça cache por código postal para sua janela de caso de uso (ex: horas a dias). Adicione comportamento stale-while-revalidate em trabalhos em segundo plano.
- Dicas de UI:
- As classificações são baseadas em letras; forneça uma legenda para evitar ambiguidade (ex: A melhor a F pior).
- Ao mostrar totais de categoria (ex: “Total Property Crime”), inclua a pontuação da categoria se presente (ex: “(B)”).
- Para contexto, adicione uma visualização de comparação de “códigos postais próximos” usando Crime Rates Nearby.
Casos de uso práticos que você pode implementar agora
- Busca de imóveis: mostre uma pílula de classificação geral por cartão de listagem usando o código postal da propriedade; expanda para a divisão de categorias na visualização detalhada.
- Ferramentas de realocação: para um código postal escolhido, busque a classificação e os códigos postais próximos para recomendar bairros mais seguros ou comparáveis.
- Operações de última milha: calcule uma pontuação de risco por código postal para planejamento de rotas e janelas de tempo de entrega.
- Portais de triagem de inquilinos: adicione um painel de risco contextual de código postal às aplicações de aluguel.
- Pré-cotação de seguros: exiba dicas de risco de localização antes de coletar formulários pesados em PII.
Chame a API de agentes de IA com MCP
Você pode invocar este mesmo endpoint de agentes de IA e IDEs compatíveis através do gateway do Modelo de Contexto da Zyla (MCP). O MCP padroniza o acesso à API para ferramentas como Claude Code, Cursor e Windsurf. Aponte seu cliente para o endpoint MCP, autorize com sua chave de API Zyla e chame a ferramenta que emite um GET para a URL da API de Dados de Crime por Código Postal com o parâmetro zip.
Documentos e detalhes de conexão: MCP. Use o mesmo Authorization: Bearer YOUR_API_KEY e preserve a URL de solicitação exata e os parâmetros descritos acima.
Lista de verificação operacional
- Entradas: valide o código postal como uma string numérica de 5 dígitos; rejeite ou sanitize caracteres não numéricos antes de chamar.
- Observabilidade: registre o ID da solicitação, código postal, código de status e metadados mínimos da resposta (ex: classificação geral) para painéis de suporte.
- Backoff: em erros transitórios ou respostas de taxa, aplique backoff exponencial e jitter; exiba uma mensagem de fallback na interface.
- Segurança: mantenha a chave da API em segredos do lado do servidor; nunca a exponha no código do lado do cliente.
- Atualização de dados: se você sincronizar periodicamente códigos postais populares, execute um trabalho agendado que aqueça seu cache para reduzir a latência percebida.
Resumo do fluxo de ponta a ponta
- O usuário seleciona um código postal ou você o infere de um geocodificador de endereço.
- Seu backend chama GET https://zylalabs.com/api/824/crime-data-by-zipcode-api/583/get-crime-rates-by-zip com zip=XXXXX e Authorization: Bearer YOUR_API_KEY.
- Analise os campos JSON que você precisa:
- Classificações gerais para a interface de nível superior.
- Crime BreakDown para dicas de ferramentas e painéis de detalhes.
- Códigos postais próximos para recomendações.
- Cache a resposta indexada por código postal; expire conforme sua programação.
- Renderize classificações e taxas em sua interface; opcionalmente adicione links para comparar códigos postais próximos.
FAQ
Qual parâmetro é necessário?
Passe zip como um número na string de consulta (exemplo: zip=01370).
Como faço para autenticar?
Envie Authorization: Bearer YOUR_API_KEY no cabeçalho da solicitação.
Posso obter comparações de códigos postais próximos?
Sim. A resposta inclui Crime Rates Nearby com códigos postais próximos e suas classificações.
Qual é o modelo de preços?
As APIs da Zyla usam assinatura + cota. Verifique a página da API para opções de acesso atuais; um teste de 7 dias começa na página do item.
Posso chamar isso de um agente de IA?
Sim, via gateway MCP da Zyla em ferramentas compatíveis. Use o mesmo cabeçalho de autorização e a URL e o parâmetro zip documentados.
Pronto para integrar? Crie sua conta no Zyla API Hub, obtenha sua chave de API e comece seu teste aqui: API de Dados de Crime por Código Postal. Uma conta, uma chave, milhares de APIs que você pode implementar esta semana.
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…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…
