Séries do Ipeadata (metadados)¶
Resumo¶
O catálogo de séries do Ipeadata é a tabela de metadados que descreve cada série de valores: base (macroeconômica, regional ou social), nome, comentário, fonte original, periodicidade, unidade, multiplicador, tema e se ainda é atualizada. É a chave para interpretar valores e valores_regional: a unidade e o fator de escala de cada série estão aqui, não nos valores.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | ipeadata/series |
| Ó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 continuamente pelo Ipea; o fetcher guarda um retrato por coleta |
| Cobertura | 2026-11 a 2026-11 |
| Unidade (uma linha) | uma série do Ipeadata |
| Granularidade | espacial: não se aplica; 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 | sercodigo |
| Colunas | 16 |
| Unidades de medida | temcodigo: código do tema (sem unidade) |
| 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 pastadimensoes/, 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
valuedo JSON e grava um único Parquet. - Entidade da API:
Metadados. O arquivo no bruto tinha 7,5 MB em 2026-11-10.
Conteúdo¶
- Uma linha por série. Amostra de 2026-11-10 (arquivo
@20261105): 4.136 séries, todas comsercodigodistinto. - Por base: 2.510 macroeconômicas (1.840 ativas e 670 inativas), 523 regionais e 1.103 sociais; séries regionais e sociais não têm situação (
serstatusvazio). - Por periodicidade (
pernome): 1.586 mensais, 1.354 anuais, 619 decenais, 469 trimestrais, 51 quadrienais, 38 diárias, 8Não se aplica, 6 irregulares e 5 quinquenais. - 91 fontes (
fntsigla) e 65 temas. Última atualização registrada: 2026-11-05. - Dos arquivos de valores no bruto, 4.138 códigos de série têm arquivo; 4.135 estão no catálogo, e 1 série do catálogo (
ivsc_ivs_capital_humano_p, base macroeconômica, anual) não tem arquivo de valores.
Variáveis¶
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
sercodigo |
SERCODIGO | texto | Código único da série | ex.: ABATE12_ABPEBO12 |
todo |
sernome |
SERNOME | texto | Nome da série, em português | — | todo |
sercomentario |
SERCOMENTARIO | texto | Comentários sobre a série, em português; pode conter HTML e tabulações | — | todo |
seratualizacao |
SERATUALIZACAO | texto | Data da última carga de dados na série | ISO 8601 com fuso | todo |
basnome |
BASNOME | texto | Nome da base de dados da série | Macroeconômico, Regional, Social | todo |
fntsigla |
FNTSIGLA | texto | Sigla ou nome abreviado da fonte da série | — | todo |
fntnome |
FNTNOME | texto | Nome completo da fonte da série | — | todo |
fnturl |
FNTURL | texto | Endereço do site da fonte da série; vazio em 415 séries | — | todo |
pernome |
PERNOME | texto | Nome da periodicidade | Diária, Mensal, Trimestral, Anual, Decenal, Quinquenal, Quadrienal, Irregular, Não se aplica | todo |
uninome |
UNINOME | texto | Nome da unidade dos valores da série | 70 unidades distintas (ex.: Tonelada, (% PIB)) |
todo |
mulnome |
MULNOME | texto | Nome do fator multiplicador dos valores da série; vazio ou espaço quando não há | mil, milhões, bilhões, centenas, centena de milhão, centavos |
todo |
serstatus |
SERSTATUS | texto | Indica se uma série macroeconômica ainda é atualizada; as regionais e sociais não têm | A = ativa, I = inativa | todo |
temcodigo |
TEMCODIGO | inteiro | Código do tema da série | ver dataset temas |
todo |
paicodigo |
PAICODIGO | texto | País ou região da série; só vale para séries macroeconômicas (vazio em 492 séries) | BRA, USA, WRLD; ver paises |
todo |
sernumerica |
SERNUMERICA | booleano | Indica se a série tem valores numéricos (verdadeiro) ou alfanuméricos (falso) | todas verdadeiras na amostra | todo |
ativa |
— (gerada) | booleano | Série ativa: verdadeiro quando serstatus é A ou vazio (regionais e sociais contam como ativas); falso para I |
3.466 verdadeiras e 670 falsas na amostra | todo |
No lake¶
- Dataset
ipeadata/series, sem partição: um Parquetmetadados.parquet. - Chave natural (amostra):
sercodigo, sem repetição. - O conversor lê
value, normaliza o nome das colunas (minúsculas, sem acento) e infere tipos:temcodigoé inteiro esernumericaé booleano; o resto é texto, inclusiveseratualizacao(data em texto). - Acrescenta
ativaa partir deserstatus. - A API do Ipeadata documenta um campo
PAICODIGOe umSERNUMERICAbit; ambos chegam como estão.
Cuidados de uso¶
- Unidade e escala moram aqui.
valores.valorvem como a fonte publicou; para saber se é R$ mil, milhões ou índice, consulteuninomeemulnomeda série. Não compare séries sem isso. mulnomecom espaço. 164 séries têmmulnomeigual a um espaço em branco e 2.891 têm nulo (conferido em 2026-11-10); trate os dois como "sem multiplicador".- Inativas. 670 séries macroeconômicas têm
serstatus = I: não são mais atualizadas. Séries regionais e sociais não têm essa informação eativaas marca como verdadeiras mesmo sem atualização garantida. - Séries de terceiros.
fntnomemostra a fonte original (91 fontes). O termo de uso do Ipeadata não detalha condições por fonte; a verificação por série não foi feita. - Sem arquivo de valores. O catálogo tem séries sem valores no bruto (1 em 2026-11-10).
- 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 (
SERNOMEvirasernome).
Exemplos¶
Séries macroeconômicas ativas mensais de fontes IBGE, com unidade e multiplicador:
import duckdb
duckdb.sql("""
SELECT sercodigo, sernome, uninome, mulnome
FROM read_parquet('lake/ipeadata/series/*.parquet')
WHERE basnome = 'Macroeconômico' AND ativa AND pernome = 'Mensal' AND fntsigla LIKE 'IBGE%'
ORDER BY sercodigo
LIMIT 20
""").show()
Referências¶
- API do Ipeadata (descrição das entidades e colunas): http://www.ipeadata.gov.br/api/
- Direitos de uso: http://www.ipeadata.gov.br/iframe_direitouso.aspx
- Ipeadata: http://www.ipeadata.gov.br