Guia prático para acessar e usar os patrimônios mundiais da UNESCO
Se você precisa listar ou consultar os patrimônios mundiais oficiais da UNESCO, a primeira coisa que todo mundo faz é ir para o site da UNESCO e tentar navegar pelo menu de lá. O problema é que a interface deles não é muito amigável para quem quer apenas extrair dados de forma programática ou organizada. A URL direta para a lista completa em JSON é https://whc.unesco.org/api/sites.json, mas ela muda de vez em quando e os campos que vêm dela são incompletos — tipo, você não recebe coordenadas exatas ou descrição detalhada sem fazer chamadas adicionais para cada sítio individualmente.
Como baixar a lista completa de patrimônios mundiais
A forma mais confiável que encontrei é usar a API mesmo, mas com um script próprio que faz cache local dos dados. Eu escrevi um script em Python básico que baixa o JSON, junta as informações de cada sítio e salva num arquivo CSV separado. O processo leva uns 10 a 15 minutos se você não tiver restrições de banda. O script pede para respeitar o rate limit da API, então coloca um sleep de 0,5 segundos entre cada requisição para não ser bloqueado. Um detalhe importante que as pessoas costumam perder: a UNESCO divide os sítios em três categorias (cultural, natural e misto), e alguns ficam em múltiplos países. Se o seu objetivo é cruzar dados geográficos ou sociais, você vai precisar normalizar os nomes dos países. A API retorna o campo "countries" como uma lista de strings, mas os nomes nem sempre estão padronizados — às vezes vem "Brazil", às vezes "Brasil". Eu resolvi isso criando um mapeamento manual de uns 40 casos problemáticos que eu identificou ao rodar o script pela primeira vez.
👉 Clique no botão abaixo para saber mais sobre o assunto!
O que funciona na prática e o que não funciona
A base de dados da UNESCO é confiável, sim, mas tem gargalos sérios. Os dados históricos de inscrição são bons, mas as descrições oficiais muitas vezes são genéricas ou repetitivas porque são traduzidas de vários idiomas. Além disso, a atualização não é frequente — alguns sítios têm informações com anos de defasagem, especialmente os que estão em países com menos recursos para gestão patrimonial. Outro problema real que eu enfrentei: a lista não inclui automaticamente os sítios em perigo de forma destacada. Para verificar quais estão na lista de risco, você precisa cruzar com a página separada dos patrimônio em perigo, que é https://whc.unesco.org/en/list/ danger. Eu fiz um parser simples que compara os IDs dos dois conjuntos e gera um arquivo com apenas os sítios em risco. Isso leva uns 30 segundos pra rodar depois que você já tem o cache local montado.
Dica técnica sobre os campos mais úteis
Dos campos que a API retorna, os que realmente valem a pena usar são: id, name, description, categories, countries, longitude, latitude e year. O resto é basicamente conteúdo redundante. Se você está construindo um painel ou análise, filtre só esses campos desde o começo para não processar dados inúteis. Eu costumo montar um dataframe com exatamente essas colunas e pronto — qualquer outra informação que você precisar depois, você busca sob demanda por ID. Tem ainda o ponto dos sítios transfronteiriços. A UNESCO conta eles como um único registro, mas eles aparecem em múltiplos países. Se o seu trabalho envolve contagem por país, tenha cuidado com isso, senão você vai subestimar o número total de sítios relacionados a determinado estado ou província. No meu script, eu dupliquei os registros para cada país envolvido, assim a contagem por-nação fica correta.
Se você não quer programar nada, existe o dataset no Google Dataset Search que agrega os dados da UNESCO, mas ele é menos atualizado do que a API direta. Eu testei os dois e a diferença de completude é visível — o dataset do Google tem uns 200 registros com campos vazios que na API vêm preenchidos. Depende do seu nível de exigência.
