YtabemiDados

API pública

Leitura das séries por programa


Acesso de leitura, sem cadastro. As respostas ficam em cache por até uma hora e as séries são atualizadas uma vez por dia. Ao usar os dados, cite a fonte original indicada em cada série.

Rotas

GET/series

Catálogo: código, nome nos três idiomas, fonte, unidade, periodicidade, tema, primeiro e último dado.

https://dados.ytabemi.com/api/v1/series

GET/series/{codigo}

Metadados e todas as observações da série, em JSON.

https://dados.ytabemi.com/api/v1/series/ipca-mensal

GET/series/{codigo}?formato=csv

CSV padrão: vírgula como separador e ponto decimal.

https://dados.ytabemi.com/api/v1/series/selic-meta?formato=csv

GET/series/{codigo}?formato=csv-br

CSV para Excel em português: ponto e vírgula como separador e vírgula decimal.

https://dados.ytabemi.com/api/v1/series/pmc-varejo-br?formato=csv-br

Exemplos

Python (pandas)

import pandas as pd

ipca = pd.read_csv("https://dados.ytabemi.com/api/v1/series/ipca-mensal?formato=csv", parse_dates=["data"])

R (readr)

library(readr)

ipca <- read_csv("https://dados.ytabemi.com/api/v1/series/ipca-mensal?formato=csv")

Os códigos das séries estão no catálogo e na rota /series. Datas seguem o padrão AAAA-MM-DD. Em séries mensais e trimestrais, a data é o primeiro dia do período; no trimestre móvel da PNAD, o primeiro dia do último mês do trimestre.