Pular para conteúdo

Países e regiões do Ipeadata

Resumo

Lista de países ou regiões associados às séries macroeconômicas (series.paicodigo). Hoje são três: Brasil, Estados Unidos e Mundial.

Ficha técnica

Campo Valor
Dataset ipeadata/paises
Órgão Instituto de Pesquisa Econômica Aplicada (Ipea)
Página oficial http://www.ipeadata.gov.br/api/
Licença Termo de Direitos de Uso do Ipeadata: o conteúdo é informação pública que pode ser livremente distribuída e copiada, com obrigação de citar a fonte Ipeadata; sem garantia de exatidão; http://www.ipeadata.gov.br/iframe_direitouso.aspx
Periodicidade atualizada pelo Ipea quando a lista muda; um retrato por coleta
Cobertura 2026-11 a 2026-11
Unidade (uma linha) um país ou região
Granularidade espacial: país; temporal: não se aplica
Formato bruto JSON da API OData v4 do Ipeadata ({"value": [...]}), UTF-8, nomes de campo em maiúsculas
Estado no lake convertido
Partições —
Chave paicodigo
Colunas 2
Unidades de medida —
Dados pessoais nenhum
Eras nenhuma
Revisado em 2026-11-10
Versão do fetcher 0.3.2

Origem e coleta

  • O fetcher chama a API OData v4 do Ipeadata (http://www.ipeadata.gov.br/api/odata4/) e grava a resposta como JSON na pasta dimensoes/, com o nome [email protected]. O carimbo é fixo e não é a data da coleta: os endpoints não informam versão, e o carimbo fixo faz o arquivo ser substituído no mesmo lugar quando a dimensão muda.
  • O conversor lê a lista value do JSON e grava um único Parquet.
  • Entidade da API: Paises.

Conteúdo

  • Uma linha por país ou região; três na amostra de 2026-11-10: BRA (Brasil), USA (Estados Unidos) e WRLD (Mundial).
  • A API documenta que o código tem três caracteres (ISO 3166-1 alfa-3) quando é país e quatro quando é região.

Variáveis

Coluna no lake Na fonte Tipo Descrição Unidade / códigos Período
paicodigo PAICODIGO texto Código do país ou região ISO 3166-1 alfa-3 para países; quatro caracteres para regiões todo
painome PAINOME texto Nome do país ou região — todo

No lake

  • Dataset ipeadata/paises, sem partição; um Parquet paises.parquet.
  • Chave: paicodigo.
  • Duas colunas de texto; sem nulos.

Cuidados de uso

  • Só valem para a base macroeconômica. Séries regionais e sociais se referem ao Brasil, mesmo com paicodigo vazio (documentação da API).
  • Retrato, sem histórico. A dimensão é a lista vigente na data da coleta (2026-11-05); mudanças anteriores não ficam registradas.
  • Nomes de coluna. O conversor passa o nome do campo da API para minúsculas, sem acento (SERNOME vira sernome).

Exemplos

import duckdb

duckdb.sql("""
    SELECT p.paicodigo, p.painome, count(*) AS series
    FROM read_parquet('lake/ipeadata/series/*.parquet') s
    JOIN read_parquet('lake/ipeadata/paises/*.parquet') p USING (paicodigo)
    GROUP BY ALL ORDER BY series DESC
""").show()

Referências

  • API do Ipeadata: http://www.ipeadata.gov.br/api/