Você está aqui: Início » API de Dados

API de Dados | Portal da Transparência do Governo Federal

Consultas disponíveis

  • Bolsa Família
    • Consulta os registros Bolsa Família por CPF ou NIS/Período

    • Consulta um registro do Bolsa Família pelo id

  • Programa de Erradicação do Trabalho Infantil (Peti)
    • Consulta os registros Programa de Erradicação do Trabalho Infantil por CPF ou NIS/Período

    • Consulta um registro do Programa de Erradicação do Trabalho Infantil pelo id

  • Garantia-Safra
    • Consulta os registros Garantia-Safra por CPF ou NIS/Período

    • Consulta um registro do Garantia-Safra pelo id

  • Seguro Defeso
    • Consulta os registros Seguro Defeso por CPF ou NIS/Período

    • Consulta um registro do Seguro Defeso pelo id

  • Cadastro de Expulsões da Administração Federal (CEAF)
    • Consulta os registros do CEAF por CPF/Órgão de Lotação/Período

    • Consulta um registro do CEAF pelo id

  • Cadastro Nacional de Empresas Inidôneas e Suspensas (CEIS)
    • Consulta os registros do CEIS por CNPJ ou CPF Sancionado/Órgão Sancionador/Período

    • Consulta um registro do CEIS pelo id

  • Cadastro Nacional de Empresas Punidas (CNEP)
    • Consulta os registros do CNEP por CNPJ ou CPF Sancionado/Órgão Sancionador/Período

    • Consulta um registro do CNEP pelo id

  • Contratos do Poder Executivo Federal
    • Consulta um contrato do Poder Executivo Federal pelo número do contrato

    • Consulta um contrato do Poder Executivo Federal pelo id

  • Convênios do Poder Executivo Federal
    • Consulta um convênio do Poder Executivo Federal pelo número do contrato

    • Consulta um contrato do Poder Executivo Federal pelo id

  • Despesas Públicas
    • Consulta todos os documentos de despesas

    • Consulta um documento pelo código (Unidade Gestora + Gestão + Número do documento)

    • Consulta as despesas do Poder Executivo Federal pela classificação funcional programática

    • Consulta as despesas dos órgão do Poder Executivo Federal

  • Entidades Privadas sem Fins Lucrativos Impedidas (CEPIM)
    • Consulta os registros do CEPIM por CNPJ ou CPF Sancionado/Órgão superior/Período

    • Consulta um registro do CEPIM pelo id

  • Licitações do Poder Executivo Federal
    • Consulta todas as licitações do Poder Executivo Federal

    • Consulta uma licitação do Poder Executivo Federal pelo número da licitação

    • Consulta uma licitação do Poder Executivo Federal pelo id

  • Notas Fiscais
    • Consulta todas as Notas Fiscais Eletrônicas do Poder Executivo Federal publicadas no Portal

    • Consulta uma Nota Fiscal Eletrônica pela chave única

  • Servidores do Poder Executivo Federal
    • Consulta um servidor do Poder Executivo Federal pelo CPF

    • Consulta um servidor do Poder Executivo Federal pelo id

  • Viagens a serviço
    • Consulta viagens por CPF/Período

    • Consulta uma viagem pelo ID

O Portal da Transparência está atento aos princípios de Governo Eletrônico e sabe que os dados devem ser disponibilizados de formas diferentes a fim de atender aos diversos perfis de usuários. Para isso, além de consultas online e com visualizações que buscam transmitir, de forma simples, como o governo usa os recursos públicos, formas de acesso aos dados para desenvolvedores e engajados com a tecnologia da informação também estão disponíveis.

O acesso para desenvolvedores e engajados ocorre através de uma Interface de Programa de Aplicativos (do inglês, “Application Programming Interface”), ou simplesmente “API”. Com ela, é possível ter um serviço de consulta direta aos dados do Portal da Transparência sem precisar navegar pelo site ou utilizar robôs para a obtenção das informações de forma automática. Os dados disponíveis são os mesmos apresentados em tela, com a flexibilidade característica das APIs.

No Portal da Transparência, o serviço de consulta via API foi implementado em REST (Representational State Transfer). Entendemos que o REST é mais simples de ser utilizado, além de poder ser testado aqui mesmo no Portal. Além do mais, o REST costuma ser a escolha preferida dos desenvolvedores.

As consultas via API têm restrição quanto ao número de requisições por minuto, de modo a não sobrecarregar o Portal da Transparência e impactar no tempo de resposta  das consultas realizadas por meio dos navegadores. No período de 6:00 às 23:59, o Portal aceita 90 requisições por minuto. Já no período das 00:00 às 5:59, são aceitas 300 requisições por minuto.

O acesso via API fornece toda uma flexibilidade para consultas pontuais. Para acesso ao conjunto completo de dados, no entanto, sugerimos utilizar as planilhas de dados abertos. O Portal da Transparência agrega uma enorme quantidade de dados e baixar as planilhas para uso local certamente fornecerá melhores resultados para grandes volumes de dados. O download de planilhas pode ser feito em seção específica.

As regras de como utilizar a API estão detalhadas abaixo na seção Exemplos. Estão disponíveis as seguintes consultas: Bolsa Família, Programa de Erradicação do Trabalho Infantil (Peti), Garantia-Safra, Seguro Defeso, Cadastro de Expulsões da Administração Federal (CEAF), Cadastro Nacional de Empresas Inidôneas e Suspensas (CEIS), Cadastro Nacional de Empresas Punidas (CNEP), Contratos do Poder Executivo Federal, Convênios do Poder Executivo Federal, Despesas Públicas, Entidades Privadas sem Fins Lucrativos Impedidas (CEPIM), Licitações do Poder Executivo Federal, Notas Fiscais Eletrônicas do Poder Executivo Federal, Servidores do Poder Executivo Federal e Viagens a Serviço. 

Mas afinal, o que é API?


A API é uma ferramenta específica para usuários técnicos que desejam obter dados sem navegar pelo Portal da Transparência. Através da API, usuários podem desenvolver programas que se conectam diretamente às máquinas do Portal da Transparência e selecionam os dados desejados. Esses dados são os mesmos obtidos em tela, ou seja, os dados obtidos via API podem também ser obtidos via consultas em tela pelos usuários não técnicos.

Em uma analogia com o mundo real, a API pode ser vista como um carro sem motorista. O carro está lá com todos os recursos disponíveis e um manual que ensina como ele deve ser utilizado. Seguindo as instruções, você pode ir para onde quiser (no caso de dados, pedir os dados que quiser). O uso do Portal sem API seria como um motorista de aplicativo ou um taxi. Nesse carro, o motorista se apresenta e você fala o caminho que quer ir (o dado que quer obter). É o motorista (no caso, o site), o responsável por guiar o carro e te levar ao local desejado (fornecer o dado).

Em outra analogia, a API pode ser vista como um quadro em branco com as tintas, pincéis e materiais necessários para fazer qualquer pintura. A navegação pelo site, ou seja, sem o uso da API, seria uma exposição de quadros onde existem quadros prontos dos melhores pintores. Você escolhe a pintura ou as pinturas que mais agradam. Com a vantagem de que, no Portal da Transparência, você não paga nada pelas diversas formas de visualização dos dados oferecidas.

Cadastro

Para fazer uso da API, deve-se realizar o cadastro de um e-mail em http://portaldatransparencia.gov.br/api-de-dados/cadastrar-email .

Através do e-mail cadastrado, você receberá um token, que deverá ser usado nas suas consultas via API.

Exemplos

Os dados dos serviços disponibilizados na API de dados deverão ser consumidos via requisições HTTP aos serviços REST. A API está documentada  em http://api.portaldatransparencia.gov.br/ e a página API de dados - Exemplos de uso apresenta exemplos de codigo-fonte de consumo da API implementados nas linguagens de programação Javascript, Java, PHP e .NET.

Termos de uso

A API de dados do Portal da Transparência do Governo Federal é de livre utilização, conforme previsto no DECRETO Nº 8.777, DE 11 DE MAIO DE 2016.

portal-web-p-deployment-5cb856f4f6-2tr6d


Formulário de dúvidas
Gostaria de receber notificações sobre atualizações de dados do Portal da Transparência? Cadastre-se aqui.

Respeitamos a sua Privacidade

Última atualização: 01/10/2024

Para melhorar a sua experiência na plataforma e prover serviços personalizados, utilizamos cookies. Para mais informações, veja a nossa Declaração de Cookies.


Classes de cookies

Cookies estritamente necessários
Sempre ativo

Esses cookies permitem funcionalidades essenciais, tais como segurança, verificação de identidade e gestão de rede. Esses cookies não podem ser desativados em nossos sistemas. Embora sejam necessários, você pode bloquear esses cookies diretamente no seu navegador, mas isso pode comprometer sua experiência e prejudicar o funcionamento do site.


Cookies de desempenho

Visam a melhoria do desempenho do site por meio da coleta de dados anonimizados sobre navegação e uso dos recursos disponibilizados. Se você não permitir a coleta desses cookies, esses dados não serão usados para melhoria do site.


Configuração de cookies no navegador

Você pode desabilitá-los alterando as configurações do seu navegador.