CEAF — Cadastro de Expulsões da Administração Federal

https://api.portaldatransparencia.gov.br/api-de-dados

chave-api-dados: SEU_TOKEN_AQUI
Accept: application/json

import requests
import pandas as pd
 
API_KEY = "SEU_TOKEN_AQUI"
BASE_URL = "https://api.portaldatransparencia.gov.br/api-de-dados"
 
headers = {
    "chave-api-dados": API_KEY,
    "Accept": "application/json",
}
 
 
def consultar_ceaf(
    nome: str = None,
    tipo_punicao: str = None,
    codigo_orgao: str = None,
    pagina: int = 1,
):
    """
    Consulta o Cadastro de Expulsões da Administração Federal.
 
    Args:
        nome: Nome do servidor (busca parcial, opcional)
        tipo_punicao: Tipo de punição (opcional)
        codigo_orgao: Código SIAFI do órgão (opcional)
        pagina: Número da página
 
    Returns:
        Lista de expulsões em formato dict
    """
    url = f"{BASE_URL}/ceaf"
    params = {"pagina": pagina}
    if nome:
        params["nomeSancionado"] = nome
    if tipo_punicao:
        params["tipoPunicao"] = tipo_punicao
    if codigo_orgao:
        params["codigoOrgaoLotacao"] = codigo_orgao
 
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()
 
 
# Exemplo: listar servidores expulsos (página 1)
expulsos = consultar_ceaf()
df = pd.DataFrame(expulsos)
print(f"Expulsões retornadas: {len(df)}")
print(df[["nomeSancionado", "cargo", "tipoPunicao", "fundamentacao"]].head())

def expulsos_por_orgao(codigo_orgao: str, pagina: int = 1):
    """
    Lista servidores expulsos de um órgão específico.
 
    Args:
        codigo_orgao: Código SIAFI do órgão
        pagina: Número da página
 
    Returns:
        Lista de expulsões do órgão
    """
    return consultar_ceaf(codigo_orgao=codigo_orgao, pagina=pagina)
 
 
# Exemplo: expulsões do INSS (33000)
expulsos_inss = expulsos_por_orgao("33000")
df_inss = pd.DataFrame(expulsos_inss)
if not df_inss.empty:
    print(f"Servidores expulsos do órgão: {len(df_inss)}")
    # Distribuição por tipo de punição
    print("\nDistribuição por tipo de punição:")
    print(df_inss["tipoPunicao"].value_counts())

import time
 
 
def coletar_expulsoes(max_paginas: int = 10):
    """
    Coleta expulsões de múltiplas páginas.
 
    Args:
        max_paginas: Número máximo de páginas a consultar
 
    Returns:
        DataFrame com as expulsões coletadas
    """
    todas = []
    for pagina in range(1, max_paginas + 1):
        dados = consultar_ceaf(pagina=pagina)
        if not dados:
            break
        todas.extend(dados)
        time.sleep(2)  # Respeitar rate limit
 
    return pd.DataFrame(todas)
 
 
df_todas = coletar_expulsoes(max_paginas=5)
if not df_todas.empty:
    print("Fundamentações mais frequentes para expulsão:")
    print(df_todas["fundamentacao"].value_counts().head(10))
    print(f"\nTotal de registros coletados: {len(df_todas)}")

import requests
import pandas as pd
import time
 
API_KEY = "SEU_TOKEN_AQUI"
BASE_URL = "https://api.portaldatransparencia.gov.br/api-de-dados"
headers = {"chave-api-dados": API_KEY, "Accept": "application/json"}
 
# Coletar expulsões de múltiplas páginas
todas = []
for pagina in range(1, 11):
    resp = requests.get(
        f"{BASE_URL}/ceaf", headers=headers, params={"pagina": pagina}
    )
    dados = resp.json()
    if not dados:
        break
    todas.extend(dados)
    time.sleep(2)
 
df = pd.DataFrame(todas)
if not df.empty:
    # Filtrar por fundamentações relacionadas a corrupção
    termos_corrupcao = ["corrupção", "vantagem", "improbidade", "lesão aos cofres"]
    mascara = df["fundamentacao"].str.lower().str.contains(
        "|".join(termos_corrupcao), na=False
    )
    df_corrupcao = df[mascara]
 
    print(f"Expulsões por corrupção/improbidade: {len(df_corrupcao)} de {len(df)}")
    print("\nÓrgãos com mais expulsões por corrupção:")
    print(df_corrupcao["orgaoLotacao"].value_counts().head(10))