ZipCodeDex

Porque existe: um dataset público que quase ninguém sabe ler

O Census Bureau dos Estados Unidos publica todos os anos a American Community Survey: milhares de tabelas, uma API e ficheiros em bruto com a radiografia demográfica do país. A informação existe e é pública, mas não é legível — quem quer saber como é de facto o 10001 de Nova Iorque ou o 90210 de Beverly Hills antes de se mudar ou investir encontra folhas de cálculo, não respostas.

O ZipCodeDex é a minha resposta a essa lacuna: um produto próprio da minha rede de sites e ferramentas que transforma esse dataset no perfil completo de cada código ZIP do país — gratuito, sem registo e diretamente a partir da fonte oficial. Desenhei-o, construí-o e sou eu que o opero, da primeira migração de dados ao último deploy.

É usado por pessoas que avaliam onde viver, por investidores imobiliários que comparam zonas e por equipas de marketing ou de expansão que precisam de perceber o rendimento e a composição de uma área antes de apostar nela. E para mim cumpre uma segunda função: é o laboratório onde levo o SEO programático à escala antes de o aplicar a projetos de clientes.

O que permite fazer

• Perfil demográfico completo. População, rendimento por agregado, valor da habitação, nível de escolaridade e emprego de cada ZIP — o 10001 de Nova Iorque, por exemplo: 30.511 habitantes e 129.852 $ de rendimento mediano.
• Comparador de dois ZIP. Métricas lado a lado com diferenças percentuais, para decidir entre duas zonas com dados e não com intuição.
• Rankings nacionais e estaduais. Seis classificações: os ZIP mais ricos, mais populosos, mais escolarizados, de melhor valor, mais jovens e mais envelhecidos.
• Páginas por estado. Estatísticas agregadas, repartição por cidades e as zonas mais bem classificadas de cada um dos 50 estados e do DC.
• Pesquisa flexível. Por código ZIP, cidade ou condado — «10001», «Miami» ou «Cook County» funcionam igualmente bem.
• Acesso livre. Sem contas, sem paywalls: dados abertos apresentados com clareza.

Como está construído

1. Arquitetura Laravel

• Laravel + PHP sobre MySQL. Cada tipo de página — ficha de ZIP, estado, ranking, comparador, pesquisa — é uma vista Blade própria, desenhada para a intenção de pesquisa que serve. Nada de templates genéricos.
• Rotas limpas e previsíveis (/zip/10001, /state/california, /richest) que fazem de cada URL uma entidade indexável com sentido próprio.
• Frontend leve: Tailwind CSS e Alpine.js compilados com Vite. Sem SPA, sem frameworks pesados de cliente — HTML servido a partir do servidor, como pede um site de conteúdos.

2. Pipeline de dados

• Importação por lotes das tabelas da ACS do Census Bureau e normalização para um esquema MySQL próprio por código ZIP.
• Agregados pré-calculados por estado e cidade no momento da importação, para que nenhum pedido tenha de calcular nada caro em tempo real.
• Rankings derivados do próprio dataset: quando o censo publica uma nova edição da ACS, o pipeline volta a correr e as 33.000+ fichas, os estados e as classificações atualizam-se de uma só vez.

3. SEO programático

• Dezenas de milhares de URLs únicos com title, meta description e dados estruturados gerados a partir dos dados reais de cada ZIP — nada de texto de enchimento clonado.
• Interligação hierárquica estado → cidade → ZIP, mais blocos de códigos em destaque que distribuem o rastreio e a autoridade interna.
• Sitemaps XML e canonicals para que os motores de busca indexem todo o catálogo sem duplicados, e um blog próprio que alimenta a parte editorial.

4. Desempenho

• Leituras simples e indexadas: com os agregados pré-calculados, cada ficha é servida com consultas triviais ao MySQL.
• Assets otimizados: CSS com preload, JavaScript mínimo por módulos e HTML estável que não provoca saltos de layout.
• Cloudflare à frente como CDN e camada de proteção anti-bots para aguentar o tráfego de rastreio que um site desta dimensão gera.

Cobertura e origem dos dados

Toda a informação vem da American Community Survey 2024, o estudo demográfico oficial do Census Bureau dos EUA. A cobertura é nacional: mais de 33.000 códigos ZIP repartidos pelos 50 estados e pelo Distrito de Columbia, cada um com a sua página de detalhe — 1.678 códigos na Califórnia, 1.491 na Florida, 1.348 no Illinois, 850 no Alabama…

As fichas em destaque dão a ideia do nível de detalhe: o 90210 de Beverly Hills regista 19.004 habitantes e 187.801 $ de rendimento mediano; o 60601 de Chicago, 15.235 habitantes e 121.458 $. Números oficiais, apresentados para que qualquer pessoa os perceba num relance.

O resultado

O ZipCodeDex está em produção, aberto e gratuito: um dataset público que quase ninguém sabia ler, transformado em dezenas de milhares de páginas únicas e indexáveis que respondem a pesquisas concretas — «demografia do 10001», «rendimento médio em Beverly Hills», «códigos postais mais ricos da Florida» — sem que eu tenha de escrever uma única à mão.

E cumpre a outra função: quando um cliente me pergunta se o SEO programático funciona mesmo, não lhe mostro um diapositivo. Mostro-lhe isto — arquitetura, pipeline de dados, indexação e desempenho a funcionar em conjunto num produto real que eu próprio mantenho.

Algumas capturas

Stack

Produto ao vivo: Visitar zipcodedex.com — aberto e sem registo.

A esclarecer dúvidas sobre o ZipCodeDex