DadosAbertosBrasil.senado

Módulo para captura de dados abertos do Senado Brasileiro.

Este módulo permite acessar informações sobre senadores, legislaturas, partidos, orçamentos e outros dados legislativos disponibilizados pelo Senado Federal.

Mini-Tutorial

  1. Importe o módulo senado:

from DadosAbertosBrasil import senado

  1. Utilize as funções lista para obter códigos necessários:

senado.lista_senadores(...)
    senado.lista_legislatura(...)

Instancie um objeto Senador para acessar informações do parlamentar:

sen = senado.Senador(cod)

Utilize os métodos da classe Senador para obter mais detalhes:

sen.cargos(...)
    sen.votacoes(...)

API Original

DadosAbertosBrasil.senado._blocos.lista_blocos(index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Obtém a lista e a composição dos Blocos Parlamentares no Congresso Nacional.

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.

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 Parlamentares no Congresso Nacional.

DadosAbertosBrasil.senado._legislaturas.lista_legislatura(inicio: int, fim: int = None, exercicio: str | None = None, participacao: Literal['titulares', 'suplentes'] | None = None, uf: str | None = None, sexo: Literal['f', 'm'] | None = None, partido: str | None = None, contendo: str | None = None, excluindo: str | None = None, 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 senadores de uma legislatura ou de um intervalo de legislaturas.

Parameters

inicioint

Código da primeira legislatura da consulta.

fimint, optional

Código da última legislatura da consulta. Se fim=None, pesquisa apenas pela legislatura do campo inicio. Caso contrário, pesquisa todas os valores de todas as legislaturas entre inicio e fim.

exerciciostr, optional

  • True: Consulta apenas os senadores que entraram em exercício.

  • False: Consulta apenas os senadores que não entratam em exercício.

participacao{“titulares”, “suplentes”}, optional

  • None: Busca qualquer tipo de participação.

  • “titulares”: Busca apenas titulares.

  • “suplentes”: Busca apenas suplentes.

ufstr, optional

Filtra uma unidade federativa. Se uf=None, lista senadores de todas as UFs.

sexo{“f”, “m”}, optional

Filtro de sexo dos senadores.

partidostr, optional

Filtro de partido dos senadores.

contendostr, optional

Captura apenas senadores contendo esse texto no nome.

excluindostr, optional

Exclui da consulta senadores contendo esse texto no nome.

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 senadores de uma legislatura ou de um intervalo de legislaturas.

Raises

DAB_UFError

Caso seja inserida uma UF inválida no argumento uf.

See Also

DadosAbertosBrasil.senado.Senador

Use o codigo para obter um detalhamento do senador.

DadosAbertosBrasil.senado.lista_senadores

Função de busca de senadores específica para a legislação atual.

Examples

Lista senadores titulares em exercício na legislatura 56.

>>> senado.lista_legislatura(
...     inicio = 56,
...     participacao = 'titulares',
...     exercicio = True
... )
   codigo         nome_parlamentar               nome_completo     0    4981             Acir Gurgacz         Acir Marcos Gurgacz   
1    5982        Alessandro Vieira           Alessandro Vieira   
2     945              Alvaro Dias       Alvaro Fernandes Dias 
..    ...                      ...                         ...

Lista mulheres senadoras do PT na legislatura 55.

>>> senado.lista_legislatura(inicio=55, partido='PT', sexo='F')
  codigo nome_parlamentar                      nome_completo      sexo     0   3713   Fátima Bezerra            Maria de Fátima Bezerra  Feminino   
1   5006  Gleisi Hoffmann             Gleisi Helena Hoffmann  Feminino   
2   5575         Marizete  Marizete Lisboa Fernandes Pereira  Feminino   
3   5182     Regina Sousa                 Maria Regina Sousa  Feminino
DadosAbertosBrasil.senado._orcamentos.lista_orcamentos(autor: str | None = None, tipo: str | None = None, ano_execucao: Annotated[int, Gt(gt=0)] | None = None, ano_materia: Annotated[int, Gt(gt=0)] | None = None, url: bool = True, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Obtém a lista dos lotes de emendas orçamentárias.

Parameters

autorstr, optional

Texto contendo nome do autor.

tipostr, optional

Tipo de orçamento.

ano_execucaoint, optional

Ano que o orçamento foi executado.

ano_materiaint, optional

Ano da matéria.

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.

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 dos lotes de emendas orçamentárias.

Examples

Buscar o orçamento da Lei de Diretrizes Orçamentárias de 2020.

>>> senado.orcamento(tipo='LDO', ano_execucao=2020)
          autor_nome  ativo                       autor_email  autor_codigo     0          Abou Anni   True        [email protected]          3896
1       Acir Gurgacz   True               [email protected]          2633
2    Adriana Ventura   True  [email protected]          3899
..               ...    ...                               ...           ...

Pesquisar por emendas da deputada Adriana Ventura

>>> senado.orcamento(autor='Adriana')
        autor_nome  ativo                       autor_email  autor_codigo     0  Adriana Ventura   True  [email protected]          3899
DadosAbertosBrasil.senado._partidos.lista_partidos(inativos: bool = False, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Lista os partidos políticos.

Parameters

inativosbool, default=False

  • True para incluir partidos inativos na lista.

  • False para listar apenas os partidos ativos.

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 os partidos políticos.

See Also

DadosAbertosBrasil.camara.lista_partidos

Função semelhante do módulo camara.

Examples

Capturar todos os partidos, incluindo inativos.

>>> senado.lista_partido(inativos=True)
   codigo          sigla                          nome data_criacao     0     525            ANL  Aliança Nacional Libertadora   1935-01-01   
1     238          ARENA   Aliança Renovadora Nacional   1965-11-24   
2     578         AVANTE                        AVANTE   2017-09-12
class DadosAbertosBrasil.senado._senadores.Senador(cod: int, verificar_certificado: bool = True)[código-fonte]

Base: Base

Coleta os dados dos senadores.

Parameters

codint

Código de senador que se dejesa consulta. O código pode ser encontrado pela função lista_senadores.

Attributes

dadosdict

Dicionário completo de dados do(a) parlamentar.

emailstr

E-mail do parlamentar.

enderecostr

Endereço da sala do parlamentar no Senado Federal.

fotostr

URL para a foto do parlamentar.

nascimentostr

Data de nascimento do parlamentar no formato “AAAA-MM-DD”.

naturalidadestr

Município de nascimento do parlamentar.

nomestr

Nome do parlamentar.

nome_completostr

Nome completo do parlamentar.

paginastr

Website do parlamentar.

partidostr

Atual partido político do parlamentar.

sexostr

Sexo (‘Masculino’ ou ‘Feminino’) do parlamentar.

telefoneslist of str

Lista de telefones oficiais do parlamentar.

tratamentostr

Pronome de tratamento usado para o parlamentar.

ufstr

Unidade Federativa pela qual o parlamentar foi eleito.

uf_naturalidadestr

Unidade Federativa de nascimento do parlamentar.

Methods

apartes()

Obtém a relação de apartes do senador.

autorias()

Obtém as matérias de autoria de um senador.

cargos()

Obtém a relação de cargos que o senador ja ocupou.

comissoes()

Obtém as comissões de que um senador é membro.

discursos()

Obtém a relação de discursos do senador.

filiacoes()

Obtém as filiações partidárias que o senador já teve.

historico()

Obtém todos os detalhes de um parlamentar no(s) mandato(s) como senador (mandato atual e anteriores, se houver).

mandatos()

Obtém os mandatos que o senador já teve.

liderancas()

Obtém os cargos de liderança de um senador.

licencas()

Obtém os cargos de liderança de um senador.

profissoes()

Obtém a(s) profissão(ões) de um senador.

relatorias()

Obtém as matérias de relatoria de um senador.

votacoes()

Obtém as votações de um senador.

Raises

DadosAbertosBrasil._utils.errors.DAB_InputError

Quando os dados do Senador não forem encontrado, por qualquer que seja o motivo.

Notes

http://legis.senado.gov.br/dadosabertos/docs/

Examples

Utilize as funções lista para identificar o código do Senado desejado.

>>> senado.lista_senadores( ... )
>>> senado.lista_legislatura( ... )

Instancie a classe Senador para obter as informações do(a) parlamentar.

>>> sen = senado.Senador(cod)

Após a class Senador ser instanciada, utilize seus métodos e atributos para buscar outros tipos de informação sobre ele(a).

>>> sen.telefones
>>> sen.partido
>>> sen.cargos( ... )
>>> sen.votacoes( ... )
>>> ...
apartes(casa: Literal['sf', 'cd', 'cn', 'pr', 'cr', 'ac'] | None = None, inicio: date | None = None, fim: date | None = None, numero_sessao: int | None = None, tipo_pronunciamento: str | None = None, tipo_sessao: str | None = None, url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Obtém a relação de apartes do senador.

Parameters

casa{“sf”, “cd”, “cn”, “pr”, “cr”, “ac”}, optional

Sigla da casa aonde ocorre o pronunciamento: - “sf”: Senado; - “cd”: Câmara; - “cn”: Congresso; - “pr”: Presidência; - “cr”: Comissão Representativa do Congresso; - “ac”: Assembléia Constituinte.

iniciodatetime or str, default=None

Data inicial do período da pesquisa.

fimdatetime or str, default=None

Data final do período da pesquisa.

numero_sessaoint, optional

Número da sessão plenária.

tipo_pronunciamentostr, optional

Sigla do tipo de pronunciamento.

tipo_sessaostr, optional

Tipo da sessão plenária.

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]

Apartes do senador.

autorias(ano: Annotated[int, Gt(gt=0)] | None = None, numero: int | None = None, primeiro_autor: bool | None = None, sigla: str | None = None, tramitando: bool | None = None, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Obtém as matérias de autoria de um senador.

Parameters

anoint, optional

Retorna apenas as matérias do ano informado.

numeroint, optional

Retorna apenas as matérias do número informado.

primeiro_autorbool, optional

  • True: Retorna apenas as matérias cujo senador é o primeiro autor;

  • False: Retorna apenas as que o senador é coautor;

  • None: Retorna ambas.

siglastr, optional

Retorna apenas as matérias da sigla informada.

tramitandobool, optional

  • True: Retorna apenas as matérias que estão tramitando;

  • False: Retorna apenas as que não estão tramitando;

  • None: Retorna ambas.

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]

Matérias de autoria do senador.

cargos(comissao: str | None = None, ativos: bool | None = None, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Obtém a relação de cargos que o senador ja ocupou.

Parameters

comissaostr, optional

Retorna apenas os cargos da sigla de comissão informada.

ativosbool, optional

  • True: Retorna apenas os cargos atuais;

  • False: Retorna apenas os cargos já finalizadas;

  • None: Retorna ambos.

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]

Relação de cargos que o senador já ocupou.

comissoes(comissao: str | None = None, ativos: bool | None = None, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Obtém as comissões de que um senador é membro.

Parameters

comissaostr, optional

Retorna apenas as comissões com a sigla informada.

ativosbool, optional

  • True: Retorna apenas as comissões atuais;

  • False: Retorna apenas as comissões já finalizadas;

  • None: Retorna ambas.

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]

Comissões que o senador é membro.

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

Obtém o histórico acadêmico de um senador.

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]

Histórico acadêmico do senador.

discursos(casa: Literal['sf', 'cd', 'cn', 'pr', 'cr', 'ac'] | None = None, inicio: date | None = None, fim: date | None = None, numero_sessao: int | None = None, tipo_pronunciamento: str | None = None, tipo_sessao: str | None = None, url: bool = True, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Obtém a relação de discursos do senador.

Se os argumentos inicio e fim não forem informados, retorna os pronunciamentos dos últimos 30 dias.

Parameters

casa{“sf”, “cd”, “cn”, “pr”, “cr”, “ac”}, optional

Sigla da casa aonde ocorre o pronunciamento: - “sf”: Senado; - “cd”: Câmara; - “cn”: Congresso; - “pr”: Presidência; - “cr”: Comissão Representativa do Congresso; - “ac”: Assembléia Constituinte.

iniciodatetime or str, default=None

Data inicial do período da pesquisa no formato ‘AAAA-MM-DD’

fimdatetime or str, default=None

Data final do período da pesquisa no formato ‘AAAA-MM-DD’

numero_sessaoint, optional

Número da sessão plenária.

tipo_pronunciamentostr, optional

Sigla do tipo de pronunciamento.

tipo_sessaostr, optional

Tipo da sessão plenária.

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]

Relação de discursos do senador.

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

Obtém as filiações partidárias que o senador já teve.

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]

Filiações partidárias que o senador já teve.

historico() → dict[código-fonte]

Obtém todos os detalhes de um parlamentar no(s) mandato(s) como senador (mandato atual e anteriores, se houver).

Returns

dict

Dados históricos do(a) parlamentar.

licencas(inicio: date | None = None, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Obtém as licenças de um senador.

Parameters

iniciodatetime or str, default=None

Retorna as licenças a partir da data especificada.

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]

Licenças do senador.

liderancas(formato: Literal['dataframe', 'json'] = 'dataframe') → DataFrame | str | dict | list[dict][código-fonte]

Obtém os cargos de liderança de um senador.

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]

Cargos de liderança do senador.

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

Obtém os mandatos que o senador já teve.

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]

Mandatos que o senador já teve.

profissoes(formato: Literal['dataframe', 'json'] = 'dataframe') → DataFrame | str | dict | list[dict][código-fonte]

Obtém a(s) profissão(ões) de um senador.

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]

Profissões do senador.

relatorias(ano: Annotated[int, Gt(gt=0)] | None = None, comissao: str | None = None, numero: int | None = None, sigla: str | None = None, tramitando: bool | None = None, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Obtém as matérias de relatoria de um senador.

Parameters

anoint, optional

Retorna apenas as matérias do ano informado.

comissaostr, optional

Retorna apenas as relatorias da comissão informada.

numeroint, optional

Retorna apenas as matérias do número informado.

siglastr, optional

Retorna apenas as matérias da sigla informada.

tramitandobool, optional

  • True: Retorna apenas as matérias que estão tramitando;

  • False: Retorna apenas as que não estão tramitando;

  • None: Retorna ambas.

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]

Matérias de relatoria do senador.

votacoes(ano: Annotated[int, Gt(gt=0)] | None = None, numero: int | None = None, sigla: str | None = None, tramitando: bool | None = None, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas') → DataFrame | str | dict | list[dict][código-fonte]

Obtém as votações de um senador.

Parameters

anoint, optional

Retorna apenas as matérias do ano informado.

numeroint, optional

Retorna apenas as matérias do número informado.

siglastr, optional

Retorna apenas as matérias da sigla informada.

tramitandobool, optional

  • True: Retorna apenas as matérias que estão tramitando;

  • False: Retorna apenas as que não estão tramitando;

  • None: Retorna ambas.

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]

Votações do senador.

DadosAbertosBrasil.senado._senadores.lista_senadores(tipo: Literal['atual', 'titulares', 'suplentes', 'afastados'] = 'atual', uf: str | None = None, sexo: Literal['f', 'm'] | None = None, partido: str | None = None, contendo: str | None = None, excluindo: str | None = None, 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 senadores da república.

Parameters

tipo{“atual”, “titulares”, “suplentes”, “afastados”}, default=”atual”

  • “atual”: Todos os senadores em exercício;

  • “titulares”: Apenas senadores que iniciaram o mandato como titulares;

  • “suplentes”: Apenas senadores que iniciaram o mandato como suplentes;

  • “afastados”: Todos os senadores afastados.

ufstr, optional

Filtro de Unidade Federativa dos senadores.

sexo{“f”, “m”}, optional

Filtro de sexo dos senadores.

partidostr, optional

Filtro de partido dos senadores.

contendostr, optional

Captura apenas senadores contendo esse texto no nome.

excluindostr, optional

Exclui da consulta senadores contendo esse texto no nome.

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 senadores da república.

Raises

DAB_UFError

Caso seja inserida uma UF inválida no argumento uf.

See Also

DadosAbertosBrasil.senado.Senador

Use o codigo para obter um detalhamento do senador.

DadosAbertosBrasil.senado.lista_legislatura

Pesquisa por senadores de outras legislaturas, além da atual.

DadosAbertosBrasil.camara.lista_deputados

Função similar para o módulo camara.

Examples

Lista todos os senadores ativos, colocando o código como index da tabela.

>>> senado.lista_senadores(index=True)
               nome_parlamentar                nome_completo     codigo                                                         
4981               Acir Gurgacz          Acir Marcos Gurgacz
5982          Alessandro Vieira            Alessandro Vieira
945                 Alvaro Dias        Alvaro Fernandes Dias
...                         ...                          ...

Lista senadores do partido PL do Rio de Janeiro.

>>> senado.lista_senadores(partido='PL', uf='RJ')
  codigo nome_parlamentar              nome_completo       sexo     0   5936  Carlos Portinho  Carlos Francisco Portinho  Masculino
1   5322          Romário     Romario de Souza Faria  Masculino

Lista senadores contendo ‘Gomes’ no nome, exceto os que contém ‘Cid’.

>>> senado.lista_senadores(contendo='Gomes', excluindo='Cid')
  codigo nome_parlamentar                nome_completo       sexo     0   3777    Eduardo Gomes  Carlos Eduardo Torres Gomes  Masculino
1   5979     Leila Barros   Leila Gomes de Barros Rêgo   Feminino
2   5557     Mailza Gomes        Mailza Assis da Silva   Feminino

Lista senadoras afastadas do sexo feminino.

>>> senado.lista_senadores(tipo='afastados', sexo='F')
  codigo nome_parlamentar                    nome_completo      sexo     0   3713   Fátima Bezerra          Maria de Fátima Bezerra  Feminino
1   5929      Juíza Selma       Selma Rosane Santos Arruda  Feminino
2   5997     Nailde Panta  Nailde Fernandes Panta da Silva  Feminino
..   ...              ...                              ...       ...
DadosAbertosBrasil.senado._usos_palavras.lista_uso_palavra(ativos: bool = False, index: bool = False, formato: Literal['json', 'pandas', 'url'] = 'pandas', verificar_certificado: bool = True) → DataFrame | str | dict | list[dict][código-fonte]

Lista os tipos de uso da palavra.

Parameters

ativosbool, default=False

Se True, retorna apenas os tipos de uso de palavra atualmente ativos.

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 os tipos de uso da palavra.