Licitações BR — PNCP

Português · English

Busca licitações e contratações públicas do Brasil direto do PNCP — Portal Nacional de Contratações Públicas, a fonte oficial da Lei 14.133/2021. Você filtra por período, UF, município, modalidade, palavras-chave e CNPJ do órgão e recebe registros estruturados, cada um com o link para conferir na fonte.

O que você recebe

Cada licitação vira um registro com:

Campo	O que é
orgao, cnpj	Órgão comprador e CNPJ
objeto	O que está sendo contratado
valorEstimado	Valor total estimado (R$), quando a fonte informa
modalidade, modoDisputa, situacao	Ex.: "Pregão - Eletrônico", "Aberto", "Divulgada no PNCP"
valorHomologado	Valor total homologado (R$); null com aviso enquanto a licitação não foi homologada
numeroCompra, processo	Número da compra e do processo administrativo, como na fonte
dataPublicacao, dataAbertura, dataEncerramentoProposta	Horário de Brasília, como na fonte
uf, municipio, codigoMunicipioIbge, unidade	Onde fica a unidade compradora
linkEdital	Página do edital no PNCP
linkSistemaOrigem	Sistema onde a disputa acontece, quando informado
numeroControlePNCP	Identificador único no PNCP

E, em todo registro, os campos de verificação:

Campo	O que é
source_url	URL do registro na API oficial do PNCP, para conferir
source_name	PNCP - API de Consulta
retrieved_at	Data e hora da coleta (ISO 8601, horário de Brasília)
status	ok, sem_resultado, fonte_indisponivel ou erro
warnings[]	Avisos sobre o registro (ex.: valor não informado); vazio se não houver
error_message	Motivo, quando o status não é ok

Sem resultado não é o mesmo que fonte fora do ar. Se a busca não encontrar nada, o dataset recebe um registro sem_resultado. Se o PNCP falhar (timeout, erro 5xx ou limite de requisições) mesmo depois das novas tentativas, o dataset recebe um registro fonte_indisponivel com a mensagem e a consulta que falhou. O Actor nunca devolve um dataset vazio em silêncio. O resumo da execução fica no key-value store, na chave RESUMO.

Filtros

Input	Como funciona
dataInicial, dataFinal	Período de publicação (AAAA-MM-DD). Padrão: últimos 7 dias. Acima de 365 dias, o período é dividido automaticamente (máx. 5 anos)
uf	Sigla do estado
municipio	Código IBGE de 7 dígitos (filtro direto na fonte, recomendado) ou nome (filtro após a coleta; informe a UF junto)
queryType	publicacao (padrão): licitações publicadas no período. proposta: somente licitações com recebimento de propostas aberto; só dataFinal vale (teto do encerramento das propostas; padrão hoje + 30 dias) e dataInicial é ignorada
modalidades	Lista de modalidades da Lei 14.133, buscadas de uma vez (ex.: pregão eletrônico e dispensa). Vazio = todas (publicação, começando por pregão eletrônico e dispensa) ou uma consulta única sem filtro (propostas abertas)
modalidade	Campo antigo, mantido por compatibilidade: uma modalidade. Se informado junto com modalidades, as duas se somam
palavrasChave	Retorna se o objeto ou a informação complementar contiver qualquer uma das palavras, como trecho de texto (sem diferenciar acentos e maiúsculas). "computador" também encontra "computadorizado"
cnpjOrgao	CNPJ do órgão comprador
maxItems	Para ao atingir este número de licitações
maxPaginasPorConsulta	Avançado: limite de páginas de 50 registros por modalidade e período
intervaloMs	Avançado: ritmo mínimo entre chamadas ao PNCP (padrão 1,2 s)

Exemplo:

{ "dataInicial": "2026-10-01", "dataFinal": "2026-10-02", "uf": "SP", "modalidade": "6", "palavrasChave": ["software", "computador"], "maxItems": 50 }

Bom saber

• Fonte oficial e pública. Só são coletados dados públicos de contratação publicados no PNCP. Nenhum dado pessoal é enriquecido nem cruzado com outras fontes (LGPD).
• Texto livre da fonte. O campo objeto (e outros textos livres) vem exatamente como o PNCP publica e pode conter dados pessoais publicados pelo próprio órgão público; o Actor não filtra, enriquece nem cruza esses dados.
• Ritmo respeitoso. A API do PNCP limita rajadas (HTTP 429). O Actor espera entre chamadas, respeita Retry-After e tenta de novo em erros temporários.
• Palavras-chave e município por nome são filtros feitos depois da coleta: em períodos longos, sem UF, eles podem varrer muitas páginas. Para buscas grandes, prefira UF, código IBGE ou modalidade.
• Valor 0 aparece em orçamentos sigilosos e registros de preços; o registro traz um aviso.

Tempo limite do run

O Actor acompanha o tempo limite da execução e encerra a coleta cerca de 45 segundos antes dele, sem iniciar novas esperas de nova tentativa que passariam do prazo. O que já foi coletado é entregue: o run termina com status parcial e motivo: tempo_limite_run no resumo (RESUMO) e na mensagem de status, com um aviso indicando onde a coleta parou. Se o prazo chegar antes de qualquer licitação, o dataset recebe um registro de status fonte_indisponivel com a mensagem tempo limite do run se aproximando; esse registro não é cobrado. Para evitar a parada, reduza o período ou as modalidades, ou aumente o timeout do run.

Preço

Pagamento por evento (licitacao-retornada): US$ 0,0009 por item (US$ 0,90 por 1.000), somente itens com status: ok. Registros de status (sem_resultado, fonte_indisponivel, erro) não são cobrados. Não há cobrança por início de execução. O teto de gasto definido por você é respeitado: ao atingi-lo, a execução para.

---

Licitações BR — Brazilian public procurement (PNCP)

Fetches Brazilian public tenders and contracts straight from PNCP — Portal Nacional de Contratações Públicas, the official source under Law 14.133/2021. Filter by date range, state (UF), municipality, procurement method, keywords and buyer CNPJ, and get structured records, each with a link to check it at the source.

Output

Each tender becomes a record with the buyer (orgao, cnpj), object (objeto), estimated value in BRL (valorEstimado), method and status (modalidade, situacao), dates in Brasília time (dataPublicacao, dataAbertura, dataEncerramentoProposta), location (uf, municipio, codigoMunicipioIbge, unidade), the PNCP notice page (linkEdital), the bidding system link (linkSistemaOrigem) and the PNCP id (numeroControlePNCP).

Every record also carries verification fields: source_url (the record in the official PNCP API), source_name, retrieved_at (ISO 8601, Brasília time), status (ok | sem_resultado | fonte_indisponivel | erro), warnings[] and error_message.

No results is not the same as source down. An empty search yields one sem_resultado record. A PNCP outage (timeout, 5xx, rate limit) that persists after retries yields a fonte_indisponivel record with the message and the failed query. The dataset is never silently empty. A run summary is saved under the RESUMO key.

Input

dataInicial / dataFinal (YYYY-MM-DD; default last 7 days; with queryType: "proposta" only dataFinal applies, as the cap for the proposal deadline, default today + 30 days, and dataInicial is ignored; ranges over 365 days are split automatically, up to 5 years), uf, municipio (7-digit IBGE code, or name filtered after fetching), modalidade (1–13; empty = all), palavrasChave (matches ANY keyword as a substring in the object or complementary info, accent- and case-insensitive), cnpjOrgao, maxItems, plus advanced maxPaginasPorConsulta and intervaloMs.

New in v2: queryType (publicacao = by publication date, default; proposta = only tenders still open for proposals) and modalidades (a list of methods queried in one run; the old single modalidade still works and is added to the list). New output fields: valorHomologado, modoDisputa, numeroCompra, processo (null plus a warning when the source omits them).

Notes

• Only public procurement data published by PNCP; no personal-data enrichment (LGPD).
• The objeto field and other free-text fields are copied as published by PNCP and may contain personal data that the public agency itself published; this Actor does not filter, enrich or cross-reference it.
• PNCP rate-limits bursts (HTTP 429); the Actor paces requests, honors Retry-After and retries transient errors.
• Keyword and municipality-name filters run after fetching; for large searches, narrow by state, IBGE code or method.
• A value of 0 usually means a confidential budget or a price registration; the record carries a warning.

Run time limit

The Actor watches the run timeout and stops collecting about 45 seconds before it, never starting a retry wait that would pass the deadline. Everything already collected is delivered: the run ends with status parcial and motivo: tempo_limite_run in the RESUMO summary and the status message, plus a warning showing where it stopped. If the deadline arrives before any tender is found, the dataset gets one free (not charged) status record fonte_indisponivel with the message tempo limite do run se aproximando. To avoid it, narrow the period or modalities, or raise the run timeout.

Pricing

Pay per event (licitacao-retornada): US$ 0.0009 per item (US$ 0.90 per 1,000), only for items with status: ok. Status records (sem_resultado, fonte_indisponivel, erro) are free. No run-start charge. Your spending limit is respected: the run stops when it is reached.

Related Actors

More Actors from the same publisher:

• Brazil Expiring Gov Contracts PNCP (Contratos a Vencer): PNCP public contracts ending within a chosen window of days, with the current supplier (company CNPJ) and value.
• Brazil Framework Agreements PNCP (Atas para Carona): Active PNCP price registration agreements (Atas de Registro de Preço) open to adhesion, with items, prices and validity.
• Brazil Public Tender Prices CATMAT/CATSER (Preço Público): Public purchase prices by CATMAT, CATSER or description from Compras.gov.br, cross-checked on PNCP.
• EU TED Tenders Scraper (Licitações da UE): EU public procurement notices from the TED Search API v3, normalized: title, buyer, country, CPV, value and deadline.
• Brazil CNPJ Bulk Lookup - Receita Federal (CNPJ em Lote): Bulk lookup of Brazilian company CNPJs in Receita Federal open data. Companies only, no partners or contacts.

Browse the full catalog: kman-br.github.io (Português).