DadosAbertosBrasil.camara

Módulo para captura de dados abertos da Câmara dos Deputados do Brasil.

Este módulo permite acessar informações detalhadas sobre deputados, partidos, frentes parlamentares, proposições, votações e outros dados legislativos disponibilizados pela API da Câmara dos Deputados.

Mini-Tutorial

Importe o módulo camara:

from DadosAbertosBrasil import camara

Busque o código do objeto de estudo utilizando as funções lista:

camara.lista_deputados(...)

Instancie o objeto de estudo utilizando o código encontrado:

dep = camara.Deputado(cod)

Utilize os atributos da classe para obter informações básicas do objeto:

dep.dados

Utilize os métodos da classe para obter informações detalhadas do objeto:

dep.despesas(...)

API Oficial

Dados Abertos da Câmara dos Deputados: https://dadosabertos.camara.leg.br/swagger/api.html

class DadosAbertosBrasil.camara._blocos.Bloco(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Informações sobre um bloco partidário específico.

Parameters

cod: int: Código numérico do bloco partidário do qual se deseja informações.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict: Conjunto completo de dados.
codint: Código numérico do bloco partidário.
legislaturastr: Legislatura do bloco partidário.
nomestr: Nome do bloco partidário.
uristr: Endereço para coleta de dados direta pela API do bloco partidário.

Examples

Obter o nome do bloco #576. >>> bl = camara.Bloco(cod=576) >>> bl.nome … ‘PSL, PTB’

DadosAbertosBrasil.camara._blocos.lista_blocos(legislatura: Annotated[int, Gt(gt=0)] | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'nome', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Lista de dados sobre os blocos partidários.

Nas atividades parlamentares, partidos podem se juntar em blocos partidários. Quando associados, os partidos passam a trabalhar como se fossem um “partidão”, com um só líder e um mesmo conjunto de vice-líderes. Os blocos só podem existir até o fim da legislatura em que foram criados: na legislatura seguinte, os mesmos partidos, se associados, formam um novo bloco. Este recurso é uma lista dos blocos em atividade no momento da requisição. Se forem passados números de legislaturas com o parâmetro legislatura, são listados também os blocos formados e extintos nessas legislaturas.

Parameters

legislaturaint, optional: Número da legislatura a qual os dados buscados devem corresponder. Se omitido, busca os dados da legislatura atual.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’nome’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de blocos partidários.

class DadosAbertosBrasil.camara._deputados.Deputado(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Retorna os dados cadastrais de um parlamentar que, em algum momento da história e por qualquer período, entrou em exercício na Câmara.

Parameters

codint: Código do parlamentar.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict

Conjunto completo de dados.

codint

Código de identificação.

condicao_eleitoralstr

Condição eleitoral.

cpfstr

Número do CPF.

descricao_statusstr

Descrição do último status.

emailstr

E-mail.

escolaridadestr

Escolaridade.

falecimentostr

Data de falecimento no formato ‘AAAA-MM-DD’. Retorna vazio caso o parlamentar não tenha falecido.

fotostr

URL da foto.

gabinetedict

Informações de identificação e contato do gabinete.

legislaturaint

ID da legislatura mais recente.

municipio_nascimentostr

Município de nascimento.

nascimentostr

Data de nascimento no formato ‘AAAA-MM-DD’.

nomestr

Nome mais comum.

nome_completostr

Nome civil completo.

nome_eleitoralstr

Nome utilizado na campanha eleitoral.

partidostr

Último partido.

rede_sociallist

Lista de nomes em redes sociais.

sexostr

‘M’: Masculino;
‘F’: Feminino.

situacaostr

Situação do último status.

ufstr

Sigla da Unidade Federativa pela qual foi eleito.

uf_nascimentostr

Unidade Federativa de nascimento.

ultima_atualizacaostr

Dia e horário da última atualização de status.

uristr

Endereço para coleta de dados direta pela API.

websitestr

Website.

Methods

despesas(): As despesas com exercício parlamentar do deputado.
discursos(): Os discursos feitos por um deputado em eventos diversos.
eventos(): Uma lista de eventos com a participação do parlamentar.
frentes(): As frentes parlamentares das quais um deputado é integrante.
ocupacoes(): Os empregos e atividades que o(a) deputado(a) já teve.
orgaos(): Os órgãos dos quais um deputado é integrante.
profissoes(): As frentes parlamentares das quais um deputado é integrante.

Examples

Coletar partido mais recente do deputado Rodrigo Maia. >>> cod = 74693 # Código do deputado >>> dep = camara.Deputado(cod=cod) >>> dep.partido … ‘DEM’

despesas(legislatura: Annotated[int, Gt(gt=0)] | None = None, ano: Annotated[int, Gt(gt=0)] | None = None, mes: Annotated[int, Gt(gt=0)] | None = None, fornecedor: int | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'ano', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

As despesas com exercício parlamentar do deputado.

Dá acesso aos registros de pagamentos e reembolsos feitos pela Câmara em prol do deputado, a título da Cota para Exercício da Atividade Parlamentar, a chamada “cota parlamentar”. Se não forem passados os parâmetros de tempo, o serviço retorna os dados dos seis meses anteriores à requisição.

Parameters

legislaturaint, optional: ID da legislatura em que tenham ocorrido as despesas.
anoint, optional: Ano de ocorrência das despesas.
mesint, optional: Número do mês de ocorrência das despesas.
fornecedorint, optional: CNPJ de uma pessoa jurídica, ou CPF de uma pessoa física, fornecedora do produto ou serviço (apenas números).
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’ano’: Nome do campo pelo qual a lista deverá ser ordenada: qualquer um dos campos do retorno, e também idLegislatura.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: As despesas com exercício parlamentar do deputado.

discursos(legislatura: Annotated[int, Gt(gt=0)] | None = None, inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'dataHoraInicio', url: bool = True, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Os discursos feitos por um deputado em eventos diversos.

Retorna uma lista de informações sobre os pronunciamentos feitos pelo deputado que tenham sido registrados, em quaisquer eventos, nos sistemas da Câmara. Caso os parâmetros de tempo não sejam configurados na requisição, são buscados os discursos ocorridos nos sete dias anteriores ao da requisição.

Parameters

legislaturaint, optional: Número da legislatura a qual os dados buscados devem corresponder.
iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’dataHoraInicio’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Os discursos feitos por um deputado em eventos diversos.

eventos(legislatura: Annotated[int, Gt(gt=0)] | None = None, inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'dataHoraInicio', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Uma lista de eventos com a participação do parlamentar.

Retorna uma lista de objetos evento nos quais a participação do parlamentar era ou é prevista. Se não forem passados parâmetros de tempo, são retornados os eventos num período de cinco dias, sendo dois antes e dois depois do dia da requisição.

Parameters

legislaturaint, optional: Número da legislatura a qual os dados buscados devem corresponder.
iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’dataHoraInicio’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Uma lista de eventos com a participação do parlamentar.

frentes(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

As frentes parlamentares das quais um deputado é integrante.

Retorna uma lista de informações básicas sobre as frentes parlamentares das quais o parlamentar seja membro, ou, no caso de frentes existentes em legislaturas anteriores, tenha encerrado a legislatura como integrante.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: As frentes parlamentares das quais um deputado é integrante.

ocupacoes(formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Os empregos e atividades que o(a) deputado(a) já teve.

Enumera as atividades profissionais ou ocupacionais que o deputado já teve em sua carreira e declarou à Câmara dos Deputados.

Parameters

formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Os empregos e atividades que o(a) deputado(a) já teve.

orgaos(inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'dataInicio', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Os órgãos dos quais um deputado é integrante.

Retorna uma lista de órgãos, como as comissões e procuradorias, dos quais o deputado participa ou participou durante um intervalo de tempo. Cada item identifica um órgão, o cargo ocupado pelo parlamentar neste órgão (como presidente, vice-presidente, titular ou suplente) e as datas de início e fim da ocupação deste cargo. Se não for passado algum parâmetro de tempo, são retornados os órgãos ocupados pelo parlamentar no momento da requisição. Neste caso a lista será vazia se o deputado não estiver em exercício.

Parameters

iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’dataInicio’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Os órgãos dos quais um deputado é integrante.

profissoes(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

As frentes parlamentares das quais um deputado é integrante.

Retorna uma lista de dados sobre profissões que o parlamentar declarou à Câmara que já exerceu ou que pode exercer pela sua formação e/ou experiência.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: As frentes parlamentares das quais um deputado é integrante.

DadosAbertosBrasil.camara._deputados.lista_deputados(nome: str | None = None, legislatura: Annotated[int, Gt(gt=0)] | None = None, uf: str | None = None, partido: str | None = None, sexo: Literal['f', 'm'] | None = None, inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'nome', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Listagem e busca de deputados, segundo critérios.

Retorna uma lista de dados básicos sobre deputados que estiveram em exercício parlamentar em algum intervalo de tempo. Se não for passado um parâmetro de tempo, como legislatura ou inicio, a lista enumerará somente os deputados em exercício no momento da requisição.

Parameters

nomestr, optional: Parte do nome dos parlamentares.
legislaturaint, optional: Número da legislatura a qual os dados buscados devem corresponder.
ufstr, optional: Sigla da unidade federativa (estados e Distrito Federal). Se None, serão retornados deputados de todos os estados.
partidostr, optional: Sigla do partido ao qual sejam filiados os deputados. Para obter as siglas válidas, consulte a função camara.lista_partidos. Atenção: partidos diferentes podem usar a mesma sigla em diferentes legislaturas.
sexo{‘f’, ‘m’}, optional: Letra que designe o gênero dos parlamentares que se deseja buscar, - ‘f’: Feminino; - ‘m’: Masculino.
iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’nome’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de deputados.

class DadosAbertosBrasil.camara._eventos.Evento(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Retorna um conjunto detalhado de informações sobre o evento da Câmara.

Parameters

codint: Código numérico do evento do qual se deseja informações.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict: Conjunto completo de dados.
codint: Código numérico do evento.
andarstr: Andar do prédio onde ocorreu o evento.
descricaostr: Descrição do evento.
descricao_tipostr: Tipo do evento.
fasesstr: Fases do evento.
fimstr: Data e horário que o evento foi finalizado no formato ‘AAAA-MM-DD’.
iniciostr: Data e horário que o evento foi iniciado no formato ‘AAAA-MM-DD’.
localstr: Local onde ocorreu o evento.
local_externostr: Local externo do evento.
lista_orgaoslist of dict: Lista de orgãos e informações sobre os mesmos.
prediostr: Prédio que ocorreu o evento.
requerimentoslist of dict: Requerimentos do evento.
salastr: Sala do prédio onde ocorreu o evento.
situacaostr: Situação do evento.
uristr: Endereço para coleta de dados direta pela API do evento.
uri_convidadosstr: Endereço para coleta de dados direta pela API dos convidados.
uri_deputadosstr: Endereço para coleta de dados direta pela API dos deputados.
url_documento_pautastr: Endereço URL para visualizar a pauta do evento.
url_registrostr: Endereço URL onde o evento foi registrado.

Methods

deputados(): Os deputados participantes do evento.
orgaos(): Lista de órgãos organizadores do evento.
pauta(): Lista de proposições que foram ou deverão ser avaliadas.
votacoes(): Informações detalhadas de votações sobre o evento.

Examples

Obter a URL para assistir ao evento #59265. >>> ev = camara.Evento(cod=59265) >>> ev.url_registro … ‘https://www.youtube.com/watch?v=8D2gjMrTnMA’

deputados(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Os deputados participantes do evento.

Retorna uma lista de dados resumidos sobre deputados participantes do evento. Se o evento já ocorreu, a lista identifica os deputados que efetivamente registraram presença no evento. Se o evento ainda não ocorreu, a lista mostra os deputados que devem participar do evento, por serem convidados ou por serem membros do(s) órgão(s) responsável pelo evento.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Os deputados participantes do evento.

orgaos(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Lista de órgãos organizadores do evento.

Retorna uma lista em que cada item é um conjunto mínimo de dados sobre o(s) órgão(s) responsável(is) pelo evento.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de órgãos organizadores do evento.

pauta(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Lista de proposições que foram ou deverão ser avaliadas em um evento de caráter deliberativo.

Se o evento for de caráter deliberativo (uma reunião ordinária, por exemplo) este serviço retorna a lista de proposições previstas para avaliação pelos parlamentares. Cada item identifica, se as informações estiverem disponíveis, a proposição avaliada, o regime de preferência para avaliação, o relator e seu parecer, o resultado da apreciação e a votação realizada.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna ordem como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de proposições.

votacoes(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Informações detalhadas de votações sobre o evento.

Retorna uma lista de dados básicos sobre votações que tenham sido realizadas no evento. Votações só ocorrem em eventos de caráter deliberativo. Dados complementares sobre cada votação listada podem ser obtidos no recurso.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Informações detalhadas de votações sobre o evento.

DadosAbertosBrasil.camara._eventos.lista_eventos(tipo_evento: Annotated[int, Gt(gt=0)] | None = None, situacao: Annotated[int, Gt(gt=0)] | None = None, tipo_orgao: Annotated[int, Gt(gt=0)] | None = None, orgao: Annotated[int, Gt(gt=0)] | None = None, inicio: date = None, fim: date = None, hora_inicio: str | None = None, hora_fim: str | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'dataHoraInicio', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Lista de eventos ocorridos ou previstos nos diversos órgãos da Câmara.

Retorna uma lista cujos elementos trazem informações básicas sobre eventos dos órgãos legislativos da Câmara, previstos ou já ocorridos, em um certo intervalo de tempo. Esse intervalo pode ser configurado pelos parâmetros de data e hora listados abaixo. Se nenhum for passado, são listados eventos dos cinco dias anteriores, dos cinco dias seguintes e do próprio dia em que é feita a requisição.

Parameters

tipo_eventoint, optional: Identificador numérico do tipo de evento que se deseja obter. Os valores válidos podem ser obtidos pela função camara.referencias(‘tiposEvento’).
situacaoint, optional: Identificador numéricos do tipo de situação de evento. Valores válidos podem ser obtidos pela função camara.referencias(‘situacoesEvento’).
tipo_orgaoint, optional: Identificador numérico do tipo de órgão realizador dos eventos que se deseja obter. Os valores válidos podem ser obtidos pela função `camara.referencias(‘tiposOrgao’).
orgaoint, optional: Identificador numérico do órgão. Os identificadores podem ser obtidos pela função camara.lista_orgaos.
iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
hora_iniciostr, optional: Hora inicial de um intervalo de tempo, no formato ‘HH:MM’, em horário de Brasília.
hora_fimstr, optional: Hora final de um intervalo de tempo, no formato ‘HH:MM’, em horário de Brasília.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’dataHoraInicio’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de eventos ocorridos ou previstos nos diversos órgãos da Câmara.

class DadosAbertosBrasil.camara._frentes.Frente(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Informações detalhadas sobre uma frente parlamentar.

Parameters

codint: Código numérico da frente parlamentar da qual se deseja informações.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict: Conjunto completo de dados.
codint: Código numérico da frente parlamentar.
coordenadordict: Informações do(a) coordenador(a) da frente parlamentar.
documentostr: URL do documento da frente parlamentar.
emailstr: E-mail de contato.
id_sitacaoint: ID da situação da frente parlamentar.
keywordsstr: Palavras-chaves da frente parlamentar.
legislaturaint: ID da legislatura da frente parlamentar.
situacaostr: Situação da frente parlamentar.
telefonestr: Telefone de contato.
titulostr: Título da frente parlamentar.
uristr: Endereço para coleta de dados direta pela API da frente parlamentar.
websitestr: URL do website da frente parlamentar.

Methods

membros(): Os deputados que participam da frente parlamentar.

Examples

Obter título da frente parlamentar #54258. >>> fr = camara.Frente(cod=54258) >>> fr.url_registro … ‘Frente Parlamentar Mista da Telessaúde’

membros(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Os deputados que participam da frente parlamentar.

Uma lista dos deputados participantes da frente parlamentar e os papéis que exerceram nessa frente (signatário, coordenador ou presidente). Observe que, mesmo no caso de frentes parlamentares mistas (compostas por deputados e senadores), são retornados apenas dados sobre os deputados.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Os deputados que participam da frente parlamentar.

DadosAbertosBrasil.camara._frentes.lista_frentes(legislatura: Annotated[int, Gt(gt=0)] | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Lista de frentes parlamentares de uma ou mais legislaturas.

Retorna uma lista de informações sobre uma frente parlamentar - um agrupamento oficial de parlamentares em torno de um determinado tema ou proposta. As frentes existem até o fim da legislatura em que foram criadas, e podem ser recriadas a cada legislatura. Algumas delas são compostas por deputados e senadores. Um número de legislatura pode ser passado como parâmetro, mas se for omitido são retornadas todas as frentes parlamentares criadas desde 2003.

Parameters

legislaturaint, optional: Número da legislatura a qual os dados buscados devem corresponder.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de frentes parlamentares de uma ou mais legislaturas.

class DadosAbertosBrasil.camara._legislaturas.Legislatura(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Informações extras sobre uma determinada legislatura da Câmara.

Parameters

codint: Código numérico da legislatura da qual se deseja informações.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict: Conjunto completo de dados.
codint: Código numérico da legislatura.
iniciostr: Primeiro dia da legislatura.
fimstr: Último dia da legislatura.
uristr: Endereço para coleta de dados direta pela API da legislatura.

Methods

mesa(): Quais deputados fizeram parte da Mesa Diretora em uma legislatura.

Examples

Obter o primeiro e último dia da legislatura #56. >>> leg = camara.Legislatura(cod=54) >>> leg.inicio … ‘2011-02-01’ >>> leg.fim … ‘2015-01-31’

Quais deputados fizeram parte da Mesa Diretora em uma legislatura.

Retorna uma lista com dados básicos sobre todos os deputados que ocuparam algum posto na Mesa Diretora da Câmara em algum período de tempo dentro da legislatura. Normalmente, cada legislatura tem duas Mesas Diretoras, com presidente, dois vice-presidentes, quatro secretários parlamentares e os suplentes dos secretários.

Parameters

iniciostr, optional: Dia de início do intervalo de tempo do qual se deseja saber a composição da Mesa, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término do intervalo de tempo do qual se deseja saber a composição da Mesa, no formato ‘AAAA-MM-DD’.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Quais deputados fizeram parte da Mesa Diretora em uma legislatura.

DadosAbertosBrasil.camara._legislaturas.lista_legislaturas(data: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = False, ordenar_por: str = 'id', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Os períodos de mandatos e atividades parlamentares da Câmara.

Legislatura é o nome dado ao período de trabalhos parlamentares entre uma eleição e outra. Esta função retorna uma lista em que cada item contém as informações básicas sobre um desses períodos. Os números que identificam as legislaturas são sequenciais, desde a primeira que ocorreu.

Parameters

datastr, optional: Data no formato ‘AAAA-MM-DD’. Se este parâmetro estiver presente, a função retornará as informações básicas sobre a legislatura que estava em curso na data informada.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=False: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’id’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Os períodos de mandatos e atividades parlamentares da Câmara.

class DadosAbertosBrasil.camara._orgaos.Orgao(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Informações detalhadas sobre um órgão da Câmara.

Parameters

codint: Código numérico do órgão do qual se deseja informações.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict: Conjunto completo de dados.
codint: Código numérico do órgão.
apelidostr: Apelido do órgão.
casastr: Casa do órgão.
cod_tipoint: Código do tipo do órgão.
fimstr: Data final do órgão.
iniciostr: Data inicial do órgão.
instalacaostr: Data de instalação do órgão.
nomestr: Nome do órgão.
nome_publicacaostr: Nome de publicação.
salastr: Sala do órgão.
siglastr: Sigla do órgão.
tipostr: Tipo do órgão.
uristr: Endereço para coleta de dados direta pela API do órgão.
urlWebsitestr: URL para acessar o website do órgão.

Methods

eventos(): Os eventos ocorridos ou previstos em um órgão legislativo.
membros(): Lista de cargos de um órgão e parlamentares que os ocupam.
votacoes(): Uma lista de eventos com a participação do parlamentar.

Examples

Obter o apelido do órgão #4. >>> org = camara.Orgao(cod=4) >>> org.apelido … ‘Mesa Diretora’

eventos(tipo_evento: str | None = None, inicio: date | None = None, fim: date | None = None, pagina: int = 1, itens: int | None = None, asc: bool = True, ordenar_por: str = 'dataHoraInicio', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Os eventos ocorridos ou previstos em um órgão legislativo.

Retorna uma lista de informações resumidas dos eventos realizados (ou a realizar) pelo órgão legislativo. Por padrão, são retornados eventos em andamento ou previstos para o mesmo dia, dois dias antes e dois dias depois da requisição. Parâmetros podem ser passados para alterar esse período, bem como os tipos de eventos.

Parameters

tipo_eventostr, optional: Identificador numérico do tipo de evento que se deseja obter.
iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’dataHoraInicio’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna id como index do DataFrame.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de discursos feitos por um deputado em eventos diversos.

membros(inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Lista de cargos de um órgão e parlamentares que os ocupam.

Retorna uma lista de dados resumidos que identificam cada parlamentar e o cargo ou posição que ocupa ou ocupou no órgão parlamentar durante um certo período de tempo. Se não forem passados parâmetros que delimitem esse período, o serviço retorna os membros do órgão no momento da requisição. Se o órgão não existir mais ou não estiver instalado, é retornada uma lista vazia.

Parameters

iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na “página” que se deseja obter com esta requisição.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de cargos de um órgão e parlamentares que os ocupam.

votacoes(proposicao: int | None = None, inicio: date | None = None, fim: date | None = None, pagina: int = 1, itens: int | None = None, asc: bool = False, ordenar_por: str = 'dataHoraRegistro', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Uma lista de eventos com a participação do parlamentar.

Retorna uma lista de dados básicos de votações que tenham sido realizadas em eventos realizados no órgão. Se este for um órgão permanente da Câmara, são retornados, por padrão, dados sobre as votações realizadas pelo órgão nos últimos 30 dias. Esse período pode ser alterado com o uso dos parâmetros inicio e/ou fim, que por enquanto são limitados a selecionar somente votações ocorridas em um mesmo ano.

Caso este seja um órgão temporário, como uma comissão especial, são listadas por padrão todas as votações ocorridas no órgão, em qualquer período de tempo. Dados complementares sobre cada votação listada podem ser obtidos com o objeto camara.Votacao.

Parameters

proposicaoint, optional: Código numérico da proposição, que podem ser obtidos por meio da função camara.lista_proposicoes. Se presente, listará as votações que tiveram a proposição como objeto de votação ou que afetaram as proposições listadas.
iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=False: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’dataHoraRegistro’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Uma lista de eventos com a participação do parlamentar.

DadosAbertosBrasil.camara._orgaos.lista_orgaos(sigla: str | None = None, tipo: Annotated[int, Gt(gt=0)] | None = None, inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'id', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Lista das comissões e outros órgãos legislativos da Câmara.

Retorna uma lista de informações básicas sobre os órgãos legislativos e seus identificadores, tipos e descrições. É possível filtrar a lista por identificadores, tipos de órgãos, sigla, situação do órgão ou período de tempo em que os órgãos estiveram ativos, se aplicável.

Parameters

siglastr, optional: Sigla oficialmente usadas para designar o órgão da câmara.
tipoint, optional: Código numérico do tipo de órgãos que se deseja buscar dados. Pode ser obtido pela função camara.referencias.
iniciostr, optional: Data de início, no formato ‘AAAA-MM-DD’, de um intervalo de tempo no qual os órgãos buscados devem ter estado em atividade.
fimstr, optional: Data de término, no formato ‘AAAA-MM-DD’, de um intervalo de tempo no qual os órgãos buscados devem ter estado em atividade.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’id’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista das comissões e outros órgãos legislativos da Câmara.

class DadosAbertosBrasil.camara._partidos.Partido(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Informações detalhadas sobre um partido.

Parameters

codint: Código numérico do partido do qual se deseja informações.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict: Conjunto completo de dados.
codint: Código numérico do partido.
facebookstr: URL da página no Facebook do partido.
legislaturastr: Código numérico da última legislatura.
liderdict: Informações sobre o líder do partido.
logostr: URL da logo do partido.
nomestr: Nome completo do partido.
numeroint: Número eleitoral do partido.
siglastr: Sigla do partido.
situacaostr: Situação do partido.
total_membrosstr: Total de membros do partido.
total_possestr: Total de posse do partido.
ultima_atualizacaostr: Última atualização das informações sobre o partido.
uristr: Endereço para coleta de dados direta pela API do partido.
uri_membrosstr: Endereço para coleta de dados direta pela API dos membros do partido.
websitestr: URL do website do partido.

Methods

membros(): Uma lista dos parlamentares de um partido durante um período.

Examples

Obter o nome completo do partido #36899. >>> p = camara.Partido(cod=36899) >>> p.nome … ‘Movimento Democrático Brasileiro’

membros(inicio: date | None = None, fim: date | None = None, legislatura: Annotated[int, Gt(gt=0)] | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, ordenar_por: str | None = None, asc: bool = True, url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Uma lista dos parlamentares de um partido durante um período.

Retorna uma lista de deputados que estão ou estiveram em exercício pelo partido. Opcionalmente, pode-se usar os parâmetros inicio, fim ou legislatura para se obter uma lista de deputados filiados ao partido num certo intervalo de tempo. Isso é equivalente à função lista_deputados com filtro por partido, mas é melhor para obter informações sobre membros de partidos já extintos.

Parameters

iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
legislaturaint, optional: Número da legislatura, à qual os dados buscados devem corresponder.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, optional: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista dos parlamentares de um partido durante um período.

DadosAbertosBrasil.camara._partidos.lista_partidos(legislatura: Annotated[int, Gt(gt=0)] | None = None, inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = True, ordenar_por: str = 'sigla', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Os partidos políticos que têm ou já tiveram parlamentares em exercício na Câmara.

Retorna uma lista de dados básicos sobre os partidos políticos que têm ou já tiveram deputados na Câmara. Se não forem passados parâmetros, a função retorna os partidos que têm deputados em exercício no momento da requisição. É possível obter uma lista de partidos representados na Câmara em um certo intervalo de datas ou de legislaturas.

Parameters

legislaturaint, optional: Número da legislatura a qual os dados buscados devem corresponder.
iniciostr, optional: Data de início de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
fimstr, optional: Data de término de um intervalo de tempo, no formato ‘AAAA-MM-DD’.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’sigla’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Os partidos políticos que têm ou já tiveram parlamentares em exercício na Câmara.

class DadosAbertosBrasil.camara._proposicoes.Proposicao(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Informações detalhadas sobre uma proposição específica.

Parameters

codint: Código numérico da proposição da qual se deseja informações.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict: Conjunto completo de dados.
codint: Código numérico da proposição.
uristr: Endereço para coleta de dados direta pela API da proposição.
tipo_siglastr: Sigla do tipo de proposição.
tipo_codigoint: Código numérico do tipo de proposição.
numeroint: Número da proposição.
anoint: Ano da proposição.
ementastr: Ementa da proposição.
apresentacaostr: Horário da apresentação da proposição no formato ‘AAAA-MM-DD HH:MM’.
uri_orgao_numeradorstr: Endereço para coleta de dados direta pela API do órgão numerador.
ultima_atualizacaostr: Data da última atualização do status da proposição.
sequenciaint: Sequência da proposição.
sigla_orgaostr: Sigla do órgão.
uri_orgaostr: Endereço para coleta de dados direta pela API do órgão.
uri_ultimo_relatorstr: Endereço para coleta de dados direta pela API do último relaltor.
regimestr: Regime da proposição.
descricao_tramitacaostr: Descrição da tramitação.
cod_tipo_tramitacaostr: Código do tipo da tramitação.
descricao_situacaostr: Descrição da situação da proposição.
cod_situacaoint: Código númerico da situação da proposição.
despachostr: Despacho.
urlstr: URL da proposição.
ambitostr: Âmbito da proposição.
uri_autoresstr: Endereço para coleta de dados direta pela API dos autores.
descricao_tipostr: Descrição do tipo da proposição.
ementa_detalhadastr: Ementa detalhada da proposição.
keywordsstr: Palavras-chaves da proposição.
uri_proposicao_principalstr: Endereço para coleta de dados direta pela API da proposição principal.
uri_proposicao_anteriorstr: Endereço para coleta de dados direta pela API da proposição anterior.
uri_proposicao_posteriorstr: Endereço para coleta de dados direta pela API da proposição posterior.
url_inteiro_teorstr: URL do inteiro teor.
urn_finalstr: URN final.
textostr: Texto da proposição.
justificativastr: Justificativa da proposição.

Examples

Obter a ementa da proposição #15990. >>> prop = camara.Proposicao(cod=15990) >>> prop.ementa … ‘’Cria salvaguardas para a tecnologia no campo nuclear…’

autores(url: bool = True, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Lista pessoas e/ou entidades autoras da proposição.

Retorna uma lista em que cada item identifica uma pessoa ou entidade que é autora da proposição. Além de deputados, também podem ser autores de proposições os senadores, a sociedade civil, assembleias legislativas e os poderes Executivo e Judiciário.

Pelo Regimento da Câmara, todos os que assinam uma proposição são considerados autores (art. 102), tanto os proponentes quanto os apoiadores.

Para obter mais informações sobre cada autor, é recomendável acessar, se disponível, a URL que é valor do campo uri.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista pessoas e/ou entidades autoras da proposição.

relacionadas(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Uma lista de proposições relacionadas a uma em especial.

Lista de informações básicas sobre proposições que de alguma forma se relacionam com a proposição, como pareceres, requerimentos, substitutivos, etc.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Uma lista de proposições relacionadas a uma em especial.

temas(index: bool = False, formato: Literal['dataframe', 'json'] = 'dataframe') → DataFrame | str | dict | list[dict][código-fonte]

Lista de áreas temáticas de uma proposição.

Lista em que cada item traz informações sobre uma área temática à qual a proposição se relaciona, segundo classificação oficial do Centro de Documentação e Informação da Câmara.

Parameters

indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de áreas temáticas de uma proposição.

O histórico de passos na tramitação de uma proposta.

Lista que traz, como cada item, um “retrato” de informações que podem ser alteradas a cada etapa de tramitação na vida da proposição (como regime de tramitação e situação) e informações sobre o que causou esse novo estado. Esta representação das tramitações ainda é provisória.

Parameters

iniciodatetime.datetime or str, optional: Data de início da tramitação, no formato ‘AAAA-MM-DD’.
fimdatetime.datetime or str, optional: Data de término da tramitação, no formato ‘AAAA-MM-DD’.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna sequencia como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: O histórico de passos na tramitação de uma proposta.

votacoes(asc: bool = False, ordenar_por: str = 'dataHoraRegistro', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Informações detalhadas de votações sobre a proposição.

Retorna uma lista de identificadores básicos sobre as votações na Câmara que tiveram a proposição como objeto ou como afetada pelos seus resultados. Dados complementares sobre cada votação listada podem ser obtidos pelo objeto camara.Votacao.

Parameters

ascbool, default=False: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’dataHoraRegistro’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Informações detalhadas de votações sobre a proposição.

DadosAbertosBrasil.camara._proposicoes.lista_proposicoes(tipo: str | None = None, numero: int | None = None, ano: Annotated[int, Gt(gt=0)] | None = None, autor_cod: int | None = None, autor_nome: str | None = None, partido_sigla: str | None = None, partido_cod: Annotated[int, Gt(gt=0)] | None = None, autor_uf: str | None = None, keyword: str | None = None, tramitacao_senado: bool = None, apresentacao_inicio: date | None = None, apresentacao_fim: date | None = None, situacao: int | None = None, tema: int | None = None, inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: int | None = None, asc: bool = True, ordenar_por: str = 'id', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Lista de proposições na Câmara.

Lista de informações básicas sobre projetos de lei, resoluções, medidas provisórias, emendas, pareceres e todos os outros tipos de proposições na Câmara. Por padrão, são retornadas todas as proposições que foram apresentadas ou tiveram alguma mudança de situação nos últimos 30 dias. Esse intervalo de tramitação pode ser configurado pelos parâmetros inicio e fim.

Se for(em) passado(s) um ou mais dos parâmetros id, ano, apresentacao_inicio, apresentacao_fim, autor_cod, autor_nome, o intervalo de tramitação só será levado em consideração se os parâmetros inico e/ou fim estiverem explicitamente configurados. Se não estiverem, poderão ser listadas proposições que não tiveram tramitação recente (e a resposta pode demorar bastante).

Parameters

tipostr, optional: Sigla do tipo das proposições que se deseja obter. A lista de tipos e siglas existentes pode ser obtida pela função camara.referencias.
numeroint, optional: Número oficialmente atribuídos às proposições segundo o art. 137 do Regimento Interno, como “PL 1234/2016”.
anoint, optional: Ano de apresentação das proposições que serão listadas no formato ‘AAAA’.
autor_codint, optional: Código numérico identificador do deputado autor das proposições que serão listadas.
autor_nomestr, optional: Nome ou parte do nome do(s) autor(es) das proposições que se deseja obter. Deve estar entre aspas.
partido_siglastr, optional: Sigla do partido a que pertençam os autores das proposições a serem listadas.
partido_codint, optional: Identificador numérico do partido a que pertençam os autores das proposições que serão listadas. Esses identificadores podem ser obtidos pela função camara.lista_partidos e são mais precisos do que as siglas, que podem ser usadas por partidos diferentes em épocas diferentes.
autor_ufstr, optional: Sigla da unidade da federação (estados e Distrito Federal) pela qual o(s) autor(es) das proposições selecionadas tenha(m) sido eleito(s).
keywordstr, optional: Palavra-chave sobre o tema a que a proposição se relaciona.
tramitacao_senadobool, optional: Buscar proposições que já tenha tramitado no Senado.
iniciostr, optional: Data do início do intervalo de tempo em que tenha havido tramitação das proposições a serem listadas, no formato ‘AAAA-MM-DD’. Se omitido, é assumido como a data de 30 dias anteriores à proposição.
fimstr, optional: Data do fim do intervalo de tempo em que tenha havido tramitação das proposições a serem listadas. Se omitido, é considerado ser o dia em que é feita a requisição.
apresentacao_iniciostr, optional: Data do início do intervalo de tempo em que tenham sido apresentadas as proposições a serem listadas, no formato ‘AAAA-MM-DD’.
apresentacao_fimstr, optional: Data do fim do intervalo de tempo em que tenham sido apresentadas as proposições a serem listadas.
situacaoint, optional: Código numérico do tipo de situação em que se encontram as proposições que serão listadas. As situações possíveis podem ser obtidas pela função camara.referencias. Atenção: este parâmetro pode apresentar resultados inesperados, por problemas com o registro dos dados.
temaint, optional: Código numérico das áreas temáticas das proposições que serão listadas. Os temas possíveis podem ser obtidos pela função camara.referencias.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=True: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’id’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de proposições na Câmara.

DadosAbertosBrasil.camara._referencias.referencias(lista: str, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Listas de valores válidos para as funções deste módulo.

Parameters

listastr: Referências que serão listadas. Deve ser uma destas opções: - “autores” - “temas” - “eventos” - “orgaos” - “proposicoes” - “tramitacoes” - “ufs” - “situacoes_deputados” - “situacoes_eventos” - “situacoes_orgaos” - “situacoes_proposicoes”
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Listas de valores válidos para as funções deste módulo.

class DadosAbertosBrasil.camara._votacoes.Votacao(cod: str, verificar_certificado: bool = True)[código-fonte]

Base: Base

Informações detalhadas sobre uma votação da Câmara.

Retorna um conjunto detalhado de dados sobre a votação, tais como as proposições que podem ter sido o objeto da votação e os efeitos de tramitação de outras proposições que eventualmente tenham sido cadastrados em consequência desta votação.

Parameters

codstr: Código alfa-numérico da votação da qual se deseja informações.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Attributes

dadosdict: Conjunto completo de dados.
codstr: Código alfa-numérico da votação.
aprovacaoint: Aprovação da votação.
datastr: Data da votação.
data_regitrostr: Data e horário de registro da votação.
data_ultima_aberturastr: Data e horário da última abertura da votação.
descricaostr: Descrição da votação.
efeitos_registradoslist: Lista de efeitos registrados.
eventoint: Código numérico do evento da votação.
orgaoint: Código numérico do órgão da votação.
objetos_possiveislist of dict: Lista de objetos possíveis.
proposicoes_afetadasstr: Proposições afetadas.
sigla_orgaostr: Sigla do órgão.
ultima_apresentacao_proposicaodict: Última apresentação da proposição.
uristr: Endereço para coleta de dados direta pela API da votação.
uri_eventostr: Endereço para coleta de dados direta pela API do evento.
uri_orgaostr: Endereço para coleta de dados direta pela API do órgão.

Examples

Obter a data da votação #2265603-43. >>> vot = camara.Votacao(cod=’2265603-43’) >>> vot.data … ‘2020-12-22’

orientacoes(url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

O voto recomendado pelas lideranças aos seus deputados na votação.

Em muitas votações, os líderes de partidos e blocos – as bancadas – fazem recomendações de voto para seus parlamentares. Essas orientações de uma votação também são feitas pelas lideranças de Governo, Minoria e as mais recentes Maioria e Oposição. Uma liderança também pode liberar a bancada para que cada deputado vote como quiser, ou entrar em obstrução, para que seus parlamentares não sejam contados para o quórum da votação.

Se a votação teve orientações, este recurso retorna uma lista em que cada item contém os identificadores de um partido, bloco ou liderança, e o posicionamento ou voto que foi recomendado aos seus parlamentares.

Até o momento, só estão disponíveis dados sobre orientações dadas em votações no Plenário.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: O voto recomendado pelas lideranças aos seus deputados na votação.

votos(url: bool = True, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Como cada parlamentar votou em uma votação nominal e aberta.

Se a votação da Câmara é nominal e não foi secreta, retorna uma lista em que cada item contém os identificadores básicos de um deputado e o voto ou posicionamento que ele registrou.

O resultado é uma lista vazia se a votação foi uma votação simbólica, em que os votos individuais não são contabilizados. Mas há algumas votações simbólicas que também têm registros de “votos”: nesses casos, normalmente se trata de parlamentares que pediram expressamente que seus posicionamentos fossem registrados.

Não são listados parlamentares ausentes à votação.

Parameters

urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Como cada parlamentar votou em uma votação nominal e aberta.

DadosAbertosBrasil.camara._votacoes.lista_votacoes(proposicao: int | None = None, evento: int | None = None, orgao: int | None = None, inicio: date | None = None, fim: date | None = None, pagina: Annotated[int, Gt(gt=0)] = 1, itens: Annotated[int, Gt(gt=0)] | None = None, asc: bool = False, ordenar_por: str = 'dataHoraRegistro', url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Lista de votações na Câmara.

Retorna uma lista de informações básicas sobre as votações ocorridas em eventos dos diversos órgãos da Câmara. Se não forem passados parâmetros que delimitem o intervalo de tempo da pesquisa, são retornados dados sobre todas as votações ocorridas nos últimos 30 dias, em eventos de todos os órgãos.

Os parâmetros de data permitem estender o período, mas por enquanto é necessário que as duas datas sejam de um mesmo ano. Quando apenas uma delas está presente, são retornadas somente as votações ocorridas no mesmo ano, antes de fim ou após inicio.

Parameters

proposicaoint, optional: Código numérico da proposição, que podem ser obtidos pela função camara.lista_proposições. Se presente, listará as votações que tiveram a proposição como objeto de votação ou que afetaram as proposições listadas.
eventoint, optional: Código numérico do evento realizado na Câmara, no qual tenham sido realizadas as votações a serem listadas. Os códigos podem ser obtidos pela função camara.lista_eventos. Somente os eventos deliberativos podem ter votações. Os eventos podem ter ocorrido fora do intervalo de tempo padrão ou definido por inicio e/ou fim.
orgaoint, optional: Código numérico do órgão da Câmara. Se presente, serão retornadas somente votações do órgão enumerado. Os códigos existentes podem ser obtidos pela função camara.lista_orgaos.
iniciostr, optional: Data em formato ‘AAAA-MM-DD’ para início do intervalo de tempo no qual tenham sido realizadas as votações a serem listadas. Se usado sozinho, esse parâmetro faz com que sejam retornadas votações ocorridas dessa data até o fim do mesmo ano. Se usado com fim, as duas datas devem ser de um mesmo ano.
fimstr, optional: Data em formato ‘AAAA-MM-DD’ que define o fim do intervalo de tempo no qual tenham sido realizadas as votações a serem listadas. Se usado sozinho, esse parâmetro faz com que sejam retornadas todas as votações ocorridas desde 1º de janeiro do mesmo ano até esta data. Se usado com inicio, é preciso que as duas datas sejam de um mesmo ano.
paginaint, default=1: Número da página de resultados, a partir de 1, que se deseja obter com a requisição, contendo o número de itens definido pelo parâmetro itens. Se omitido, assume o valor 1.
itensint, optional: Número máximo de itens na página que se deseja obter com esta requisição.
ascbool, default=False: Se os registros são ordenados no sentido ascendente: - True: De A a Z ou 0 a 9 (ascendente); - False: De Z a A ou 9 a 0 (descendente).
ordenar_porstr, default=’dataHoraRegistro’: Qual dos elementos da representação deverá ser usado para aplicar ordenação à lista.
urlbool, default=False: Se False, remove as colunas contendo URI, URL e e-mails. Esse argumento é ignorado se formato for igual a ‘json’.
indexbool, default=False: Se True, define a coluna codigo como index do DataFrame. Esse argumento é ignorado se formato for igual a ‘json’.
formato{“json”, “pandas”, “url”}, default=”pandas”: Formato do dado que será retornado: - “json”: Dicionário com as chaves e valores originais da API; - “pandas”: DataFrame formatado; - “url”: Endereço da API que retorna o arquivo JSON.
verificar_certificadobool, default=True: Defina esse argumento como False em caso de falha na verificação do certificado SSL.

Returns

pandas.core.frame.DataFrame | str | dict | list[dict]: Lista de votações na Câmara.