Portal da Transparência

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_despesas_por_orgao(codigo_orgao: str, mes_ano: str, pagina: int = 1):
    """
    Consulta despesas de um órgão federal em determinado mês/ano.
 
    Args:
        codigo_orgao: Código SIAFI do órgão (ex: '26000' para MEC)
        mes_ano: Mês/Ano no formato YYYYMM (ex: '202401')
        pagina: Número da página para paginação
 
    Returns:
        Lista de registros de despesa em formato dict
    """
    url = f"{BASE_URL}/despesas/por-orgao"
    params = {
        "codigoOrgao": codigo_orgao,
        "mesAno": mes_ano,
        "pagina": pagina,
    }
 
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()
 
 
# Exemplo: Consultar despesas do Ministério da Educação (26000) em janeiro/2024
dados = consultar_despesas_por_orgao("26000", "202401")
df = pd.DataFrame(dados)
print(df.head())

def consultar_servidores(codigo_orgao: str, pagina: int = 1):
    """
    Lista servidores federais vinculados a um órgão.
 
    Args:
        codigo_orgao: Código SIAFI do órgão
        pagina: Número da página
 
    Returns:
        Lista de servidores
    """
    url = f"{BASE_URL}/servidores/por-orgao"
    params = {
        "codigoOrgao": codigo_orgao,
        "pagina": pagina,
    }
 
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()
 
 
servidores = consultar_servidores("26000")
for s in servidores[:5]:
    print(f"{s.get('nome', 'N/A')} - {s.get('cargo', 'N/A')}")

def consultar_ceis(cnpj: str = None, pagina: int = 1):
    """
    Consulta o Cadastro de Empresas Inidôneas e Suspensas.
 
    Args:
        cnpj: CNPJ da empresa (opcional)
        pagina: Número da página
 
    Returns:
        Lista de sanções
    """
    url = f"{BASE_URL}/ceis"
    params = {"pagina": pagina}
    if cnpj:
        params["cnpjSancionado"] = cnpj
 
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()
 
 
# Consultar todas as empresas sancionadas (página 1)
sancoes = consultar_ceis()
df_sancoes = pd.DataFrame(sancoes)
print(f"Total de sanções na página: {len(df_sancoes)}")
print(df_sancoes[["cnpjSancionado", "nomeSancionado", "dataInicioSancao"]].head())

def consultar_bolsa_familia_municipio(codigo_ibge: str, mes_ano: str, pagina: int = 1):
    """
    Consulta pagamentos do Bolsa Família por município.
 
    Args:
        codigo_ibge: Código IBGE do município (ex: '3550308' para São Paulo)
        mes_ano: Mês/Ano no formato YYYYMM
        pagina: Número da página
 
    Returns:
        Dados de pagamentos do programa
    """
    url = f"{BASE_URL}/novo-bolsa-familia-por-municipio"
    params = {
        "codigoIbge": codigo_ibge,
        "mesAno": mes_ano,
        "pagina": pagina,
    }
 
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()
 
 
# Bolsa Família em São Paulo, janeiro/2024
bf = consultar_bolsa_familia_municipio("3550308", "202401")
print(f"Registros retornados: {len(bf)}")

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"}
 
# 1. Obter lista de empresas sancionadas (CEIS)
resp_ceis = requests.get(f"{BASE_URL}/ceis", headers=headers, params={"pagina": 1})
empresas_sancionadas = pd.DataFrame(resp_ceis.json())
 
# 2. Obter licitações recentes
resp_licit = requests.get(
    f"{BASE_URL}/licitacoes",
    headers=headers,
    params={"dataInicio": "01/01/2024", "dataFim": "31/01/2024", "pagina": 1},
)
licitacoes = pd.DataFrame(resp_licit.json())
 
# 3. Cruzar por CNPJ para identificar empresas sancionadas em licitações
if not empresas_sancionadas.empty and not licitacoes.empty:
    cruzamento = pd.merge(
        licitacoes,
        empresas_sancionadas[["cnpjSancionado", "nomeSancionado", "categoriaSancao"]],
        left_on="cnpjFornecedor",
        right_on="cnpjSancionado",
        how="inner",
    )
    print(f"Empresas sancionadas encontradas em licitações: {len(cruzamento)}")
    print(cruzamento[["nomeSancionado", "categoriaSancao", "objeto"]].head())