DataAn

API de dados abertos

Tudo o que você vê no site está disponível como arquivos estáticos em JSON e CSV. Sem cadastro, sem chave e sem limite de uso, servidos por CDN. Atualizados uma vez por dia.

Tutorial no Colab: do catálogo à análise

Endpoints

CaminhoConteúdo
/data/catalog.jsonCatálogo: categorias, conjuntos, indicador de destaque e se está desatualizado.
/data/datasets/{slug}.jsonConjunto completo: indicadores, gráficos (com os pontos), análises, metodologia e fontes.
/data/csv/{slug}.csvDados tabulares completos em CSV (UTF-8, vírgula como separador, ponto decimal).
/data/status.jsonSaúde do pipeline: última execução, erros e histórico.

Slugs disponíveis: selic, ipca, dolar, desemprego, dengue-capitais, estudo-dengue-clima, qualidade-do-ar, temperatura-capitais, populacao-uf.

Python

import pandas as pd
import requests

base = "https://dataan.vercel.app/data"
catalogo = requests.get(f"{base}/catalog.json", timeout=30).json()

df = pd.read_csv(f"{base}/csv/selic.csv")
print(df.tail())

JavaScript

const base = "https://dataan.vercel.app/data";
const res = await fetch(`${base}/datasets/selic.json`);
const dataset = await res.json();
console.log(dataset.kpis);

Terminal

curl -s https://dataan.vercel.app/data/catalog.json

Boas práticas

  • O campo schema_version muda quando o formato muda de forma incompatível.
  • Use updated_at (quando coletamos) e data_until (último dado da fonte) para saber a atualidade.
  • Se stale for verdadeiro no catálogo, a última coleta falhou e o arquivo é a versão válida anterior.
  • Os dados pertencem às fontes originais: cite-as conforme a licença indicada em cada conjunto.