Monitore oportunidades de compras públicas e contratos do PNCP

Pesquise e exporte licitações, pregões eletrônicos, dispensas e contratos públicos brasileiros a partir da API oficial de consulta do PNCP — Portal Nacional de Contratações Públicas.

O Actor foi feito para transformar dados públicos de compras governamentais em um dataset estruturado que pode ser usado para:

• prospecção B2G;
• monitoramento de novas oportunidades;
• inteligência comercial;
• análise de órgãos compradores;
• acompanhamento de contratos firmados;
• pesquisa de fornecedores vencedores;
• integração com CRM, planilhas, n8n, Make, APIs e pipelines internos.

Sem login. Sem CAPTCHA. Sem navegador.

Principais recursos

• Licitações e contratações publicadas
• Pregões eletrônicos
• Dispensas
• Contratos firmados
• Janela relativa de datas para monitoramento diário
• Janela absoluta para pesquisas históricas
• Filtro por modalidade
• Filtro por UF
• Filtro por município
• Filtro por CNPJ do órgão
• Filtro por palavras-chave no objeto
• Órgão comprador
• Valores estimados e homologados quando públicos
• Fornecedor contratado no modo contratos
• Valores inicial e global do contrato
• Datas de abertura e encerramento de propostas
• Links para o sistema de origem
• Schema único e estável
• Health checks e diagnósticos em STATS
• Fatiamento automático de janelas longas
• Retry e backoff
• Resultado parcial transparente quando uma fatia falha
• Pay Per Event: cobrança apenas por registros escritos

Actor comunitário não-oficial. Sem afiliação com o Governo Federal, o PNCP ou qualquer órgão público. Os dados vêm da API pública de consulta do PNCP e permanecem sujeitos às condições e políticas da fonte.

---

Para quem é

Fornecedores do governo e equipes B2G

Monitore novas oportunidades relacionadas ao seu mercado.

Exemplos de palavras-chave:

software
merenda
pavimentação
equipamentos médicos
manutenção predial
uniformes
serviços de TI
consultoria

Combine palavras-chave com:

• UF;
• município;
• modalidade;
• órgão comprador.

Exemplo de pergunta que o Actor ajuda a responder:

Quais pregões eletrônicos relacionados a software foram publicados em São Paulo nos últimos 3 dias?

---

Consultorias de licitação

Use o modo:

contratacoes

para acompanhar oportunidades publicadas.

Use o modo:

contratos

para analisar contratos já firmados, incluindo quando disponíveis:

• fornecedor contratado;
• CNPJ/identificação do fornecedor;
• valor inicial;
• valor global;
• vigência;
• órgão comprador.

---

Inteligência comercial e concorrencial

Pesquise:

• quais órgãos estão comprando;
• o que estão comprando;
• valores estimados;
• fornecedores contratados;
• localização;
• modalidade;
• frequência de contratação;
• contratos firmados.

Os dados podem alimentar análises comerciais e B2G, mas o Actor não classifica automaticamente uma licitação como adequada para sua empresa.

---

Integradores e equipes de automação

A saída estruturada pode ser conectada a:

• n8n;
• Make;
• Google Sheets;
• Slack;
• CRM;
• webhooks;
• bancos de dados;
• agentes de IA;
• dashboards;
• aplicações internas.

---

Dois modos de operação

O Actor possui dois modos principais:

contratacoes
contratos

---

Modo contratacoes

É o modo padrão.

Retorna contratações e publicações do PNCP no período selecionado.

Pode incluir:

• pregões;
• dispensas;
• outras modalidades suportadas pela consulta oficial;
• objeto da contratação;
• órgão comprador;
• modalidade;
• situação;
• valor total estimado;
• valor homologado;
• abertura de proposta;
• encerramento de proposta;
• processo;
• amparo legal;
• link para o sistema de origem.

Exemplo:

{
  "modo": "contratacoes",
  "diasRetroativos": 3,
  "modalidades": [6],
  "uf": "SP",
  "palavrasChave": [
    "merenda",
    "alimentação escolar"
  ],
  "maxResults": 500
}

---

Modo contratos

Retorna contratos firmados no período.

Pode incluir:

• órgão comprador;
• objeto;
• fornecedor contratado;
• identificação do fornecedor;
• valor inicial;
• valor global;
• data de assinatura;
• início da vigência;
• fim da vigência;
• tipo de contrato;
• número do contrato;
• ano do contrato.

Exemplo:

{
  "modo": "contratos",
  "diasRetroativos": 30,
  "uf": "RS",
  "maxResults": 500
}

---

Janela de datas

O Actor suporta dois tipos de janela.

Janela relativa

Use:

diasRetroativos

Exemplo:

{
  "diasRetroativos": 3
}

A janela é recalculada em cada execução.

Isso torna o modo relativo especialmente útil para Tasks e Schedules da Apify.

Um Task salvo hoje continua funcionando amanhã sem precisar editar datas manualmente.

---

Janela absoluta

Use as duas propriedades:

dataInicial
dataFinal

no formato:

AAAAMMDD

Exemplo:

{
  "dataInicial": "20260701",
  "dataFinal": "20260731"
}

Quando as duas datas absolutas são fornecidas, elas têm precedência sobre:

diasRetroativos

---

Fatiamento automático de janelas longas

A API do PNCP pode ficar instável em consultas muito grandes.

Por isso, o Actor divide automaticamente janelas maiores em consultas de aproximadamente:

3 dias

por fatia.

Cada fatia possui:

• retry controlado;
• backoff;
• registro de sucesso ou falha.

Uma única fatia com erro não derruba automaticamente toda a coleta.

Falhas ficam registradas em:

STATS.sliceFailures

A execução só falha globalmente quando a quantidade de falhas ultrapassa o limite de tolerância definido pelo Actor.

---

Input

Exemplo recomendado para monitoramento diário

{
  "modo": "contratacoes",
  "diasRetroativos": 3,
  "modalidades": [6],
  "uf": "SP",
  "palavrasChave": [
    "merenda",
    "alimentação escolar"
  ],
  "maxResults": 500
}

Campos de input

Campo	Tipo	Default	Descrição
modo	string	contratacoes	contratacoes para publicações ou contratos para contratos firmados.
diasRetroativos	int 1–90	3	Janela relativa quando as datas absolutas estão vazias.
dataInicial / dataFinal	AAAAMMDD	—	Janela absoluta. As duas devem ser fornecidas juntas e têm precedência.
modalidades	int[]	[6]	Códigos oficiais de modalidade usados no modo contratacoes. Cada código gera uma consulta própria.
uf	string	—	Sigla da UF, como SP, MG, RS. O filtro é enviado à API quando suportado pela consulta.
municipio	string	—	Filtro pós-coleta por nome do município. Acentos são ignorados.
cnpjOrgao	string	—	CNPJ do órgão, com 14 dígitos. Pontuação é ignorada.
palavrasChave	string[]	[]	Basta uma palavra-chave casar com o objeto. Comparação ignora acentos e diferença entre maiúsculas/minúsculas.
maxResults	int	100	Máximo de registros escritos no dataset. Limite máximo: 10.000.

---

Modalidades

No modo:

contratacoes

a API exige código de modalidade.

Cada modalidade selecionada gera uma consulta separada.

Exemplos documentados no Actor:

6 = Pregão eletrônico
8 = Dispensa

Use os códigos oficiais do PNCP conforme a documentação pública da API de consulta.

Exemplo com múltiplas modalidades

{
  "modo": "contratacoes",
  "diasRetroativos": 3,
  "modalidades": [6, 8],
  "uf": "MG",
  "maxResults": 200
}

Como cada modalidade produz sua própria consulta, adicionar modalidades aumenta o volume de requisições.

---

Filtros

Os filtros não são todos aplicados no mesmo estágio.

Filtro enviado à API

Quando aplicável:

uf
modalidades

fazem parte das consultas ao PNCP.

Filtros pós-coleta

Estes são aplicados pelo Actor após receber os registros:

municipio
cnpjOrgao
palavrasChave

Registros descartados por esses filtros não são escritos no dataset.

---

Filtro por palavras-chave

palavrasChave procura correspondências no:

objeto

da contratação ou contrato.

Exemplo:

{
  "palavrasChave": [
    "software",
    "sistema",
    "licença"
  ]
}

Basta uma das palavras casar.

A comparação ignora:

• diferença entre maiúsculas e minúsculas;
• acentuação.

---

Filtro por município

Exemplo:

{
  "municipio": "Lajeado"
}

O filtro é aplicado após a coleta.

---

Filtro por órgão

Use:

cnpjOrgao

Exemplo:

{
  "cnpjOrgao": "87297982000103"
}

Pontuação no CNPJ é ignorada.

---

Output

Os dois modos usam um shape único.

Campos que não se aplicam ao registro retornam:

null

em vez de serem inventados.

---

Exemplo real de contratação

Estrutura de um pregão eletrônico publicado no PNCP:

{
  "fonte": "contratacoes",
  "numeroControlePNCP": "87297982000103-1-000233/2026",
  "dataPublicacaoPncp": "2026-07-29T00:00:48",
  "orgaoCnpj": "87297982000103",
  "orgaoRazaoSocial": "MUNICIPIO DE LAJEADO",
  "uf": "RS",
  "municipio": "Lajeado",
  "objeto": "REGISTRO DE PREÇOS PARA A CONTRATAÇÃO, SOB DEMANDA, DE SERVIÇOS COM EQUIPAMENTOS RODOVIÁRIOS...",
  "modalidadeCodigo": 6,
  "modalidadeNome": "Pregão - Eletrônico",
  "situacao": "Divulgada no PNCP",
  "valorTotalEstimado": 10011189.5,
  "dataAberturaProposta": "2026-07-29T08:00:00",
  "dataEncerramentoProposta": "2026-08-08T09:00:00",
  "linkSistemaOrigem": "https://pregaobanrisul.com.br/editais/0041_2026/354183",
  "fornecedorNome": null,
  "valorGlobal": null
}

---

Campos de output

Campo	Presença	Descrição
fonte	sempre	contratacoes ou contratos.
numeroControlePNCP	core	Identificador oficial no PNCP.
dataPublicacaoPncp	core	Data/hora da publicação.
objeto	core	Objeto da contratação ou contrato.
orgaoCnpj	core	CNPJ do órgão comprador.
orgaoRazaoSocial	core	Razão social/nome do órgão.
orgaoPoder	alta	Poder quando disponível.
orgaoEsfera	alta	Esfera quando disponível.
uf	alta	UF da unidade compradora.
municipio	alta	Município.
codigoIbge	alta	Código IBGE quando disponível.
unidadeNome	alta	Unidade compradora.
modalidadeCodigo	contratações	Código da modalidade.
modalidadeNome	contratações	Nome da modalidade.
situacao	contratações	Situação publicada pelo PNCP.
valorTotalEstimado	quando público	Valor estimado.
valorTotalHomologado	quando público	Valor homologado.
dataAberturaProposta	quando aplicável	Início da recepção/abertura de propostas.
dataEncerramentoProposta	quando aplicável	Encerramento da proposta.
tipoInstrumento	contratações	Tipo de instrumento quando disponível.
amparoLegal	contratações	Referência legal.
amparoLegalDescricao	contratações	Descrição do amparo legal.
modoDisputa	contratações	Modo de disputa quando disponível.
srp	contratações	Indicador relacionado a sistema de registro de preços, quando informado.
anoCompra	alta	Ano da compra.
numeroCompra	alta	Número da compra.
sequencialCompra	alta	Sequencial da compra.
processo	alta	Processo administrativo quando informado.
fornecedorNi	contratos	Identificação do fornecedor contratado.
fornecedorNome	contratos	Nome/razão social do fornecedor contratado.
valorInicial	contratos	Valor inicial do contrato.
valorGlobal	contratos	Valor global quando informado.
dataAssinatura	contratos	Data de assinatura.
dataVigenciaInicio	contratos	Início da vigência.
dataVigenciaFim	contratos	Fim da vigência.
tipoContrato	contratos	Tipo de contrato.
numeroContrato	contratos	Número do contrato.
anoContrato	contratos	Ano do contrato.
linkSistemaOrigem	quando informado	Link para o sistema onde o processo se originou.
linkProcessoEletronico	quando informado	Link para processo eletrônico.
informacaoComplementar	variável	Informação complementar.
usuarioNome	variável	Metadado de origem quando disponível.
dataAtualizacao	variável	Data de atualização.
scrapedAt	sempre no Actor	Timestamp da coleta.

---

Campos core e health check

O Actor monitora campos essenciais.

Entre os campos core estão:

numeroControlePNCP
dataPublicacaoPncp
objeto
orgaoCnpj
orgaoRazaoSocial

Se mais de 50% dos registros retornarem um campo core como null, a execução falha explicitamente com:

DEAD_FIELDS

e informa o campo afetado.

Isso ajuda a evitar que uma mudança no contrato da API gere silenciosamente um dataset quebrado.

---

STATS

O registro:

STATS

no key-value store contém informações operacionais como:

• completude por campo;
• número de consultas;
• consultas por fatia;
• retries;
• fatias concluídas;
• fatias com falha;
• avisos;
• indicadores de qualidade.

Para janelas fatiadas, os campos podem incluir:

slicesOk
slicesTotal
sliceFailures
warnings
qualityAlert

---

Resultado parcial transparente

Se algumas fatias falharem mesmo após retries, o Actor pode entregar os dados coletados pelas fatias saudáveis.

Nessa situação:

qualityAlert

é ativado e os detalhes das falhas ficam em:

sliceFailures[]

Cada falha pode registrar informações como:

code
message
query

Isso evita que um resultado parcial seja apresentado silenciosamente como se a coleta tivesse sido completa.

---

Janela legitimamente vazia

Uma consulta pode não ter nenhuma publicação no período.

Exemplo:

feriado + diasRetroativos: 1

Quando a API responde corretamente sem registros, o Actor trata isso como uma janela vazia legítima.

O status fica disponível em:

STATS.legitimateEmptyWindow

Isso é diferente de:

• timeout;
• erro HTTP;
• rate limit;
• mudança no contrato da API;
• falha de parsing.

---

Códigos de erro

Falhas podem ser registradas em:

ERRORS

com códigos estáveis como:

HTTP_UNAVAILABLE
HTTP_TIMEOUT
INVALID_INPUT
API_CONTRACT_CHANGED
SLICE_FAILED
EMPTY_RESULTS
DEAD_FIELDS
HTTP_RATE_LIMITED

---

Monitoramento diário

O uso recomendado para busca de oportunidades é uma Task com janela relativa.

Exemplo:

{
  "modo": "contratacoes",
  "diasRetroativos": 3,
  "modalidades": [6, 8],
  "uf": "SP",
  "palavrasChave": [
    "software",
    "tecnologia"
  ],
  "maxResults": 500
}

Salve como Task e execute diariamente.

A janela relativa será recalculada automaticamente em cada run.

---

Agendamento na Apify

Use Apify Schedules para executar o Actor na nuvem.

Exemplo

1. Salve sua configuração como uma Task.
2. Vá em Console → Schedules → Create schedule.
3. Adicione a Task.
4. Defina a frequência.
5. Envie o dataset para o destino desejado.

Exemplo de cron diário às 6h:

0 6 * * *

Destinos possíveis:

• Slack;
• Google Sheets;
• n8n;
• Make;
• CRM;
• webhook;
• banco de dados;
• dashboard;
• aplicação interna.

Seu computador não precisa permanecer ligado.

---

Exemplo de pipeline B2G

Input

{
  "modo": "contratacoes",
  "diasRetroativos": 3,
  "modalidades": [6],
  "uf": "MG",
  "palavrasChave": [
    "software",
    "sistema de gestão",
    "automação"
  ],
  "maxResults": 300
}

Fluxo possível

1. O Actor consulta o PNCP.
2. Filtra as contratações.
3. Escreve apenas os registros que passaram pelos filtros.
4. O dataset vai para Google Sheets, CRM ou banco de dados.
5. Um fluxo downstream pode:
   • classificar oportunidades;
   • adicionar responsáveis;
   • criar alertas;
   • gerar resumos;
   • alimentar um agente de IA;
   • comparar oportunidades com o portfólio da empresa.

O Actor fornece os dados estruturados.

A qualificação comercial final é responsabilidade do workflow downstream.

---

Exemplo de inteligência de contratos

Use:

{
  "modo": "contratos",
  "diasRetroativos": 30,
  "uf": "SP",
  "maxResults": 1000
}

O dataset pode ser usado para analisar:

• órgãos compradores;
• fornecedores contratados;
• valores;
• vigência;
• objetos;
• concentração de contratos por setor;
• histórico recente de compras públicas.

---

API da Apify

Execute o Actor e receba os itens do dataset em uma chamada:

curl -s "https://api.apify.com/v2/acts/<SEU_USUARIO>~pncp-licitacoes-brasil/run-sync-get-dataset-items?token=<SEU_TOKEN>" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"diasRetroativos":1,"modalidades":[6,8],"uf":"MG","maxResults":200}'

---

Cobrança

Este Actor usa Pay Per Event.

Você paga pelos registros efetivamente escritos no dataset.

Registros descartados por:

• filtros;
• município;
• CNPJ do órgão;
• palavras-chave;
• maxResults

não são cobrados como eventos de resultado.

A aba Pricing da página do Actor é sempre a fonte autoritativa para os valores vigentes e qualquer taxa de início de execução.

---

Controle de custo

Os principais campos que controlam volume são:

diasRetroativos
modalidades
uf
municipio
cnpjOrgao
palavrasChave
maxResults

Menor custo e maior foco

Use:

• janela curta;
• poucas modalidades;
• filtros mais específicos;
• maxResults explícito.

Pesquisa histórica mais ampla

Janelas longas e múltiplas modalidades podem gerar mais consultas e maior volume.

---

Limites honestos

A modalidade é obrigatória no modo contratações

A API de consulta exige modalidade nesse modo.

Cada código selecionado gera uma consulta separada.

---

Janelas grandes podem sofrer rate limit

Sob volume, a API do PNCP pode responder com:

HTTP 429

O Actor usa retries e backoff.

Quando nem todas as fatias completam, o resultado parcial é marcado explicitamente em STATS.

---

Alguns filtros são pós-coleta

Estes filtros são aplicados depois que os dados chegam ao Actor:

municipio
cnpjOrgao
palavrasChave

O custo de infraestrutura da coleta é tratado internamente pelo Actor.

Somente registros escritos no dataset são cobrados como eventos de resultado.

---

Valores podem ser nulos

Alguns valores podem não estar disponíveis publicamente.

O Actor retorna:

null

em vez de inventar um valor.

---

Resultado do PNCP não substitui o edital

O dataset facilita pesquisa e automação.

Antes de tomar decisões comerciais ou participar de uma contratação, consulte:

• o edital;
• o processo;
• os anexos;
• o sistema de origem;
• as informações oficiais atualizadas.

---

O Actor não envia notificações por conta própria

Ele gera o dataset.

Para receber notificações, conecte a execução ou o dataset a:

• Slack;
• email via workflow;
• webhook;
• n8n;
• Make;
• CRM;
• outro sistema de alertas.

---

Perguntas frequentes

Preciso de login no PNCP?

Não.

Preciso de chave de API do PNCP?

Não.

O Actor usa a API pública de consulta documentada para esse fluxo.

O Actor usa navegador?

Não.

Ele consulta a API diretamente.

Posso procurar pregões eletrônicos?

Sim.

Use o código de modalidade correspondente.

No exemplo documentado:

6 = Pregão eletrônico

Posso procurar dispensas?

Sim.

No exemplo documentado:

8 = Dispensa

Posso monitorar apenas um estado?

Sim.

Exemplo:

{
  "uf": "RS"
}

Posso filtrar um município?

Sim.

Exemplo:

{
  "municipio": "Lajeado"
}

Posso filtrar por CNPJ do órgão?

Sim.

Use:

cnpjOrgao

Posso procurar palavras dentro do objeto?

Sim.

Exemplo:

{
  "palavrasChave": [
    "software",
    "automação"
  ]
}

Basta uma das palavras casar.

Posso procurar contratos já firmados?

Sim.

Use:

{
  "modo": "contratos"
}

O modo contratos retorna fornecedor?

Quando disponível na fonte, o schema inclui:

fornecedorNi
fornecedorNome

Ele mostra valor do contrato?

Quando disponível, o schema inclui:

valorInicial
valorGlobal

Ele retorna link para o processo?

Quando informado pelo PNCP, os campos podem incluir:

linkSistemaOrigem
linkProcessoEletronico

O que acontece se não houver licitações na janela?

Uma resposta vazia legítima é registrada através de:

STATS.legitimateEmptyWindow

O que acontece se uma fatia falhar?

A falha é registrada em:

STATS.sliceFailures

e as demais fatias podem continuar.

Posso agendar diariamente?

Sim.

O modo com:

diasRetroativos

é especialmente adequado para isso.

Posso integrar com n8n ou Make?

Sim.

Use o dataset, a API da Apify, webhooks ou as integrações disponíveis.

O Actor qualifica automaticamente a licitação para minha empresa?

Não.

Ele coleta e filtra dados.

A qualificação comercial pode ser feita em um workflow downstream.

Pelo que eu pago?

Por registros escritos no dataset conforme o modelo Pay Per Event do Actor.

Consulte sempre a aba Pricing para os valores atuais.

O Actor tem ligação com o Governo Federal ou PNCP?

Não.

É um Actor comunitário não-oficial que consome dados públicos da API de consulta do PNCP.

---

Parte da suíte JM Forge

Também do mesmo desenvolvedor:

• Consulta CNPJ Brasil e Empresas por CNAE — consulte CNPJs em lote e encontre empresas brasileiras por CNAE, estado e município usando dados cadastrais públicos.

• Google Maps Business Leads Scraper — extraia dados públicos de empresas do Google Maps para prospecção, pesquisa de mercado e CRM.

• ATS Hiring Signals — Greenhouse, Lever & Ashby — monitore vagas recentes em empresas por meio das APIs públicas de Greenhouse, Lever e Ashby.

---

English Summary

Brazil PNCP Public Procurement & Contracts

Search and monitor Brazilian public procurement data through the public PNCP consultation API.

The Actor supports two modes:

contratacoes

Published procurement opportunities such as tenders, e-auctions, direct purchases, estimated values, proposal deadlines, agencies, modalities, and source links.

contratos

Signed public contracts with fields such as awarded supplier information, contract values, dates, and validity when available.

Main features

• relative date windows through diasRetroativos;
• absolute date windows;
• UF filtering;
• municipality filtering;
• agency CNPJ filtering;
• keyword filtering;
• procurement modality selection;
• automatic date-window slicing;
• retries and backoff;
• transparent partial-result diagnostics;
• stable normalized JSON;
• STATS and ERRORS;
• Apify Schedules;
• API and integration workflows.

No PNCP login or CAPTCHA is required.

This is an unofficial community Actor and is not affiliated with the Brazilian Federal Government, PNCP, or any public agency.

Support

Report issues in the Issues tab of this actor — I respond within 24h. Feature requests welcome.

Suporte (pt-BR): relate qualquer problema na aba Issues deste actor — respondo em até 24h. Sugestões de funcionalidades são bem-vindas.