PNCP Scraper – Licitações e Contratos | Public Tenders

Consulte licitações, contratações e contratos do Portal Nacional de Contratações Públicas (PNCP). Brazil government tenders / public procurement data for B2G sales, bids and compliance.

O que faz / What it does

Consulte licitações, contratações e contratos do Portal Nacional de Contratações Públicas (PNCP). Brazil government tenders / public procurement data for B2G sales, bids and compliance.

Roda na plataforma Apify: agende execuções, exporte em JSON, CSV, Excel ou via API, e integre com Make, Zapier, n8n, Google Sheets ou webhooks. / Runs on Apify: schedule runs, export JSON/CSV/Excel, or pull results via API and integrations.

Casos de uso / Use cases

• Encontrar licitações para vender ao governo (B2G)
• Monitorar contratos de concorrentes
• Análise de gastos públicos / transparência

Exemplo de input / Input example

{
  "searchMode": "proposta",
  "keyword": "saúde",
  "uf": "BA",
  "maxItems": 5
}

Campos de saída / Output fields

Cada item do dataset inclui, entre outros / Each dataset item includes:

• id
• recordType
• orgao
• uf
• municipio
• objeto
• valorEstimado
• modalidade
• situacao
• dataPublicacaoPncp
• linkPncp

Preço / Pricing

Modelo pay-per-event (você paga só pelo que usar; uso da plataforma Apify cobrado à parte conforme seu plano) / Pay-per-event pricing:

• Actor Start (apify-actor-start): US$ 5e-05 — Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event).
• result (apify-default-dataset-item): US$ 0.002 — Single result in the default dataset.
• Dataset item (dataset-item): US$ 0.002 — Single result in the dataset.

Os valores vigentes estão sempre na aba Pricing do Actor. / Current prices are always shown in the Actor's Pricing tab.

FAQ

Precisa de login ou conta no site? / Do I need a login? Não. O Actor usa apenas páginas e dados públicos. / No, only public pages and data are used.

É legal? / Is it legal? O Actor coleta somente informação publicamente disponível. Você é responsável por usar os dados em conformidade com a LGPD e os termos do site de origem. / Only public data is collected; you are responsible for LGPD/GDPR-compliant use.

Posso agendar e integrar? / Can I schedule and integrate? Sim — use Schedules, a API do Apify, webhooks ou integrações (Make, Zapier, n8n, Google Sheets).

O que acontece se o site bloquear? / What if the site blocks requests? Use Apify Proxy (de preferência residencial com país BR). Bloqueios e CAPTCHAs geram erro explícito em vez de dados inventados.

Encontrou um problema? / Found an issue? Abra uma issue na aba Issues do Actor.

Detalhes técnicos / Technical details

Official Brazilian public-procurement API → structured contracting and contract records.

Colete contratações e contratos publicados no Portal Nacional de Contratações Públicas — a fonte única da Lei 14.133/2021 — sem HTML scraping e sem login.

• Lê a API oficial de consulta (pncp.gov.br/api/consulta/v1), a mesma documentada no Swagger do portal.
• Filtra por objeto (local), UF, município/IBGE, CNPJ do órgão, modalidade e janela de publicação.
• Devolve id PNCP, órgão, UF, objeto, valores, modalidade, datas, situação e link do edital/contrato.
• HTTP barato (fetch JSON) — boa margem PPE. Proxy opcional: a API costuma ser aberta.
• Dedup por numeroControlePNCP e teto rígido de maxItems (5.000).
• Página HTML de challenge/CAPTCHA encerra o run (fail closed). Sem bypass.

Fontes oficiais (verificado em 2026-09-05)

Swagger UI: pncp.gov.br/api/consulta/swagger-ui/index.html
OpenAPI: GET https://pncp.gov.br/api/consulta/v3/api-docs
Base: https://pncp.gov.br/api/consulta/v1

Endpoint	O que lista	Parâmetros obrigatórios
GET /contratacoes/proposta	Contratações com recebimento de proposta aberto	dataFinal (YYYYMMDD), pagina
GET /contratacoes/publicacao	Contratações por data de publicação	dataInicial, dataFinal, codigoModalidadeContratacao, pagina
GET /contratacoes/atualizacao	Contratações por data de atualização global	iguais à publicação
GET /contratos	Contratos por data de publicação	dataInicial, dataFinal, pagina
GET /orgaos/{cnpj}/compras/{ano}/{sequencial}	Detalhe de uma compra	path

Filtros opcionais nas contratações: uf, codigoMunicipioIbge, cnpj (órgão), codigoModalidadeContratacao (já opcional em proposta).

tamanhoPagina mínimo 10 (a API devolve 400 abaixo disso). Não há parâmetro de palavra-chave — o Actor aplica keyword / nome de órgão / nome de município no JSON recebido.

Portal: https://pncp.gov.br/app/editais/{cnpj}/{ano}/{sequencial} e https://pncp.gov.br/app/contratos/{cnpj}/{ano}/{sequencial}.

Itens da compra

GET /api/consulta/v1/orgaos/{cnpj}/compras/{ano}/{seq}/itens → 404
GET /api/pncp/v1/orgaos/{cnpj}/compras/{ano}/{seq}/itens → 5xx recorrente

O Actor não depende de itens para ter sucesso. includeItens=true tenta uma vez e segue só com o objeto se falhar.

Há também APIs em compras.dados.gov.br (ComprasNet legado). Este Actor usa o PNCP, que é o cadastro nacional vigente.

Amostra de saída

Estrutura real da API de consulta (campos nulos quando o portal não publica o valor):

{
  "id": "13915632000127-1-000207/2025",
  "recordType": "contratacao",
  "orgao": "MUNICIPIO DE JUAZEIRO",
  "orgaoCnpj": "13915632000127",
  "uf": "BA",
  "municipio": "Juazeiro",
  "objeto": "Credenciamento de prestadores de serviços de saúde…",
  "valorEstimado": 570018.24,
  "modalidade": "Credenciamento",
  "situacao": "Divulgada no PNCP",
  "linkPncp": "https://pncp.gov.br/app/editais/13915632000127/2025/207"
}

Exemplo ilustrativo de formato — rode o Actor para dados atuais.

Configuração

Campo	Default	Descrição
searchMode	proposta	proposta / publicacao / atualizacao / contratos
keyword	—	Filtro local no objeto
uf	—	Sigla ou nome; vai na query da API
municipio	—	IBGE 7 dígitos ou nome
orgao	—	Filtro local na razão social
cnpjOrgao	—	Query cnpj / cnpjOrgao
cnpjFornecedor	—	Só contratos; filtro local
modalidadeId	—	Obrigatório em publicacao/atualizacao (6 = pregão eletrônico)
publicationDateFrom / To	até = hoje	YYYY-MM-DD ou YYYYMMDD
maxItems	50	Teto 5.000
includeItens	false	Tentativa extra, fail-soft
proxyConfiguration	—	Opcional

PPE

Evento dataset-item: US$ 2,00 / 1.000 registros sugerido.

LGPD

Editais, valores e razões sociais de órgãos e fornecedores são dados públicos de contratação. Não coletamos documentos internos nem cadastros autenticados.

Desenvolvimento

cd actors/pncp-scraper
npm install && npm test && npm run build
apify run