Contratos Federais

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 listar_contratos(
    data_inicial: str,
    data_final: str,
    codigo_orgao: str = None,
    pagina: int = 1,
):
    """
    Lista contratos federais em um período.
 
    Args:
        data_inicial: Data inicial (DD/MM/AAAA)
        data_final: Data final (DD/MM/AAAA)
        codigo_orgao: Código SIAFI do órgão (ex: '26000' para MEC)
        pagina: Número da página
 
    Returns:
        Lista de contratos em formato dict
    """
    url = f"{BASE_URL}/contratos"
    params = {
        "dataInicial": data_inicial,
        "dataFinal": data_final,
        "pagina": pagina,
    }
    if codigo_orgao:
        params["codigoOrgao"] = codigo_orgao
 
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()
 
 
# Exemplo: contratos do Ministério da Saúde (36000) em janeiro/2024
contratos = listar_contratos("01/01/2024", "31/01/2024", "36000")
df = pd.DataFrame(contratos)
print(f"Contratos encontrados: {len(df)}")
print(df[["numero", "orgaoContratante", "fornecedor", "valorInicial"]].head())

def detalhar_contrato(contrato_id: int):
    """
    Obtém detalhes completos de um contrato específico.
 
    Args:
        contrato_id: ID do contrato no Portal da Transparência
 
    Returns:
        Dicionário com detalhes do contrato
    """
    url = f"{BASE_URL}/contratos/{contrato_id}"
    response = requests.get(url, headers=headers)
    response.raise_for_status()
    return response.json()
 
 
# Exemplo: detalhar contrato pelo ID obtido na listagem
if not df.empty:
    primeiro_id = df.iloc[0]["id"]
    detalhes = detalhar_contrato(primeiro_id)
    print(f"Objeto: {detalhes.get('objeto', 'N/A')}")
    print(f"Valor inicial: R$ {detalhes.get('valorInicial', 0):,.2f}")
    print(f"Fornecedor: {detalhes.get('fornecedor', 'N/A')}")

def contratos_por_fornecedor(cnpj: str, data_inicial: str, data_final: str):
    """
    Busca contratos federais de um fornecedor específico.
 
    Args:
        cnpj: CNPJ do fornecedor (apenas números)
        data_inicial: Data inicial (DD/MM/AAAA)
        data_final: Data final (DD/MM/AAAA)
 
    Returns:
        Lista de contratos do fornecedor
    """
    url = f"{BASE_URL}/contratos"
    params = {
        "cnpjContratado": cnpj,
        "dataInicial": data_inicial,
        "dataFinal": data_final,
        "pagina": 1,
    }
 
    response = requests.get(url, headers=headers, params=params)
    response.raise_for_status()
    return response.json()
 
 
# Exemplo: buscar contratos de um fornecedor
contratos_fornecedor = contratos_por_fornecedor(
    "00000000000191", "01/01/2024", "31/12/2024"
)
print(f"Contratos do fornecedor: {len(contratos_fornecedor)}")

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 contratos recentes
resp_contratos = requests.get(
    f"{BASE_URL}/contratos",
    headers=headers,
    params={"dataInicial": "01/01/2024", "dataFinal": "31/03/2024", "pagina": 1},
)
contratos = pd.DataFrame(resp_contratos.json())
 
# 2. Obter empresas sancionadas (CEIS)
resp_ceis = requests.get(f"{BASE_URL}/ceis", headers=headers, params={"pagina": 1})
sancionadas = pd.DataFrame(resp_ceis.json())
 
# 3. Cruzar por CNPJ
if not contratos.empty and not sancionadas.empty:
    alerta = pd.merge(
        contratos,
        sancionadas[["cnpjSancionado", "nomeSancionado", "categoriaSancao"]],
        left_on="cnpjContratado",
        right_on="cnpjSancionado",
        how="inner",
    )
    print(f"ALERTA: {len(alerta)} contratos com fornecedores sancionados!")
    if not alerta.empty:
        print(alerta[["numero", "nomeSancionado", "categoriaSancao", "valorInicial"]])