# Editais e Licitações API - Oportunidades Públicas no Brasil (`brasildados/editais-licitacoes-brasil`) Actor

Busque editais e licitações públicas abertas no Brasil por palavra-chave, estado, modalidade e esfera de governo. Encontre oportunidades federais, estaduais e municipais com prazos, valores, órgãos, localização e link oficial. Exporte em JSON, CSV, Excel ou consulte pela API.

- **URL**: https://apify.com/brasildados/editais-licitacoes-brasil.md
- **Developed by:** [BrasilDados.org - API e Data as a Service](https://apify.com/brasildados) (community)
- **Categories:** Lead generation, Other, Integrations
- **Stats:** 36 total users, 4 monthly users, 95.8% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $25.00 / 1,000 por edital encontrados

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### 🔎 O que é a API de Editais e Licitações do Brasil?

Busque **somente** editais em aberto / recebendo proposta **e** editais futuros (a receber). Não retorna julgamento nem encerradas.

Filtre por palavra-chave, estado, modalidade e esfera. Cada edital vem com objeto, prazos, valor estimado, órgão, localização e link oficial.

Cada edital ocupa uma linha pronta para exportação em **JSON, CSV, Excel ou XML**. Você também pode integrar a busca aos seus sistemas pela API da Apify, em execução por lote.

> **Entrada simples:** pesquise por uma palavra-chave como `software`, escolha os filtros opcionais e defina o máximo de resultados.

### O que este scraper de licitações faz?

- Retorna só editais em aberto / recebendo proposta e editais futuros.
- Pesquisa produtos, serviços e temas pelo objeto da contratação.
- Filtra oportunidades por UF, modalidade e esfera de governo.
- Calcula quantos dias restam até o encerramento das propostas.
- Organiza CNPJ, órgão, unidade administrativa e localização.
- Remove prefixos técnicos do objeto para facilitar leitura e análise.
- Entrega o link público oficial de cada edital sem realizar consultas adicionais.
- Exporta os resultados em JSON, CSV, Excel e XML.

### 🎯 Para que usar os dados?

#### Prospecção de vendas B2G

Encontre órgãos públicos procurando os produtos e serviços oferecidos pela sua empresa. Use palavras-chave relacionadas ao seu mercado para criar uma lista de oportunidades comerciais.

#### Monitoramento de editais

Execute buscas diariamente e receba novos editais por integração, webhook ou agendamento. Os campos `propostaFechaEm` e `diasAteFechamento` ajudam a priorizar oportunidades urgentes.

#### Inteligência de mercado público

Analise quais órgãos, estados, municípios, modalidades e esferas concentram compras relacionadas ao seu setor.

#### Pesquisa de fornecedores e concorrentes

Combine os editais com outros dados empresariais para estudar mercados atendidos, órgãos compradores e oportunidades regionais.

### Como buscar editais e licitações?

1. Informe uma **palavra-chave**, como `software`, `material hospitalar` ou `energia solar`.
2. Se desejar, escolha o **estado**, a **modalidade** e a **esfera de governo**.
3. Defina o **máximo de resultados**.
4. Clique em **Start**.
5. Abra o Dataset para consultar ou exportar os editais encontrados.

O Actor **só** devolve editais em aberto / recebendo proposta e editais futuros. Palavra-chave, UF, modalidade e esfera são opcionais.

### ⚙️ Entrada

| Campo | Obrigatório | Descrição | Exemplo |
|---|---:|---|---|
| `palavraChave` | Não | Produto, serviço ou tema procurado no objeto do edital | `software` |
| `uf` | Não | Sigla de um estado brasileiro | `SP` |
| `modalidade` | Não | Modalidade da contratação | `Pregão Eletrônico` |
| `esfera` | Não | `Federal`, `Estadual` ou `Municipal` | `Estadual` |
| `maxResultados` | Não | Quantidade máxima de editais, entre 1 e 5.000 | `100` |

Exemplo de busca por oportunidades de software em São Paulo:

```json
{
  "palavraChave": "software",
  "uf": "SP",
  "modalidade": "Pregão Eletrônico",
  "esfera": "Estadual",
  "maxResultados": 100
}
```

Para pesquisar nacionalmente, você pode enviar somente:

```json
{
  "palavraChave": "material hospitalar",
  "maxResultados": 100
}
```

### 📦 Saída

Cada edital efetivamente entregue ocupa **uma linha** no Dataset: **um objeto JSON plano** (campos na raiz, sem objetos aninhados — exporta limpo em CSV/Excel).

| Campo | Descrição |
|---|---|
| `referencia` | Identificador opaco e estável gerado para o edital |
| `referenciaOficial` | Número oficial de controle da contratação |
| `urlOficial` | Link público para abrir o edital |
| `titulo` | Título da publicação |
| `objeto` | Descrição normalizada do produto, serviço ou contratação |
| `tipoInstrumento` | Tipo do instrumento convocatório |
| `modalidade` | Modalidade da contratação |
| `situacao` | Situação informada para o edital |
| `aberto` | Indica se o prazo de propostas permanece aberto |
| `cancelado` | Indica se a oportunidade foi cancelada |
| `valorEstimado` | Valor estimado em reais, quando disponível |
| `propostaAbreEm` | Início da janela de propostas |
| `propostaFechaEm` | Encerramento da janela de propostas |
| `diasAteFechamento` | Dias corridos restantes |
| `publicadoEm` | Data de publicação |
| `atualizadoEm` | Data da atualização mais recente |
| `numero`, `ano`, `numeroSequencial` | Identificação administrativa do edital |
| `orgaoCnpj`, `orgaoCnpjFormatado`, `orgaoNome` | Órgão comprador |
| `orgaoSubrogadoId`, `orgaoSubrogadoNome` | Órgão sub-rogado, quando houver |
| `unidadeCodigo`, `unidadeNome` | Unidade administrativa |
| `esfera`, `poder` | Esfera e poder público |
| `uf`, `municipio` | Localização |
| `fonteOrcamentaria` | Fonte dos recursos, quando informada |
| `exigeConteudoNacional` | Indica exigência de conteúdo nacional |
| `permiteAdesao` | Indica possibilidade de adesão a ata |
| `possuiEmendaParlamentar` | Indica vínculo com emenda parlamentar |
| `margemPreferencia` | Margem de preferência, quando aplicável |
| `consultadoEm` | Data e hora da coleta |

Exemplo completo e compatível com a estrutura real:

```json
{
  "referencia": "bd-9db58dabf737",
  "referenciaOficial": "71584833000195-1-000132/2026",
  "urlOficial": "https://pncp.gov.br/app/editais/71584833000195/2026/132",
  "titulo": "Edital nº 108/2026",
  "objeto": "Contratação de serviço de tecnologia da informação para disponibilização de ambiente em nuvem, suporte técnico, manutenção e rotinas de backup.",
  "tipoInstrumento": "Edital",
  "modalidade": "Pregão - Eletrônico",
  "situacao": "Divulgada no PNCP",
  "aberto": true,
  "cancelado": false,
  "valorEstimado": 850000,
  "propostaAbreEm": "2026-08-18T08:00:00.000Z",
  "propostaFechaEm": "2026-09-01T09:00:00.000Z",
  "diasAteFechamento": 17,
  "publicadoEm": "2026-08-14T19:37:21.168Z",
  "atualizadoEm": "2026-08-14T19:37:21.168Z",
  "numero": "108",
  "ano": "2026",
  "numeroSequencial": "132",
  "orgaoCnpj": "71584833000195",
  "orgaoCnpjFormatado": "71.584.833/0001-95",
  "orgaoNome": "PROCURADORIA GERAL DO ESTADO",
  "orgaoSubrogadoId": null,
  "orgaoSubrogadoNome": null,
  "unidadeCodigo": "990182",
  "unidadeNome": "CENTRO DE ESTUDOS",
  "esfera": "Estadual",
  "poder": "Executivo",
  "uf": "SP",
  "municipio": "São Paulo",
  "fonteOrcamentaria": "Estadual",
  "exigeConteudoNacional": false,
  "permiteAdesao": null,
  "possuiEmendaParlamentar": null,
  "margemPreferencia": null,
  "consultadoEm": "2026-08-15T12:00:00.000Z"
}
```

Campos não disponibilizados para determinado edital são retornados como `null`, sem inventar informações.

### Quanto custa buscar editais?

Cobrança **por linha no Dataset** (`apify-default-dataset-item`): **US$ 0,04** por edital entregue.

- Sem resultados: nenhuma cobrança.
- Duplicata: removida antes da entrega.
- Limite de gasto: o que não couber não é empurrado ao Dataset.
- `maxResultados` limita o teto de linhas (e de custo).

| Volume | Custo |
|---|---|
| 100 editais | US$ 4,00 |
| 500 editais | US$ 20,00 |
| 1.000 editais | US$ 40,00 |

### 🚀 Usar pela API da Apify

Execute o Actor e receba os editais do Dataset na própria resposta:

```bash
curl -X POST "https://api.apify.com/v2/acts/brasildados~editais-licitacoes-brasil/run-sync-get-dataset-items?format=json" \
  -H "Authorization: Bearer SEU_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"palavraChave":"software","uf":"SP","modalidade":"Pregão Eletrônico","maxResultados":100}'
```

No Console, a aba **Output** abre em uma visão de resumo com as colunas principais. Troque para a visão **Todos os campos** para ver o registro inteiro. O download em JSON, CSV ou Excel e a API sempre trazem todos os campos, independente da visão escolhida.

Você fornece apenas o token da Apify. Não é necessário cadastrar uma chave externa nos dados de entrada.

### ⚠️ Limitações

- A cobertura depende das publicações disponibilizadas pelas fontes públicas.
- Alguns órgãos não informam valor estimado, fonte orçamentária ou outros campos opcionais.
- A busca retorna só editais em aberto / recebendo proposta e editais futuros. Não cobre julgamento nem encerradas.
- Cada execução aceita uma UF, uma modalidade e uma esfera. A fonte pública processa somente uma UF por consulta; deixe o filtro vazio para pesquisar todo o Brasil.
- Mudanças ou indisponibilidade temporária nas fontes públicas podem afetar a consulta.
- O Actor não substitui a leitura do edital, seus anexos e requisitos na página oficial.

### ❓ Perguntas frequentes

#### Como encontrar licitações abertas por produto ou serviço?

Informe o produto ou serviço em `palavraChave`. Só entram editais em aberto / recebendo proposta e editais futuros.

#### Posso buscar licitações de todo o Brasil?

Sim. Deixe `uf` vazio para pesquisar oportunidades nacionais.

#### Posso exportar os editais para Excel?

Sim. Abra o Dataset da execução e selecione XLSX, CSV, JSON ou outro formato oferecido pela Apify.

#### O link do edital é retornado?

Sim. Quando disponível, `urlOficial` abre a página pública oficial da oportunidade.

#### Como evitar gastar mais do que desejo?

Reduza `maxResultados` e configure o limite máximo de cobrança da execução na Apify.

### Suporte

Use a aba de suporte do Actor e envie o ID da execução, os dados de entrada sem credenciais, o resultado esperado e uma descrição objetiva do problema.

Depois de várias execuções com resultado, avalie na aba **Reviews** da Store.

### Loja BrasilDados

Catálogo: [apify.com/brasildados](https://apify.com/brasildados?fpr=t5lwzq)

### Outros Actors da BrasilDados

| Actor | Para que serve |
|---|---|
| [Gerador de Leads por CNAE](https://apify.com/brasildados/gerador-de-leads-scraper-cnae?fpr=t5lwzq) | Encontre empresas brasileiras por atividade econômica |
| [Enriquecimento de Empresas por CNPJ](https://apify.com/brasildados/enriquecimento-lista-empresas-por-cnpj?fpr=t5lwzq) | Complete listas empresariais usando CNPJs |
| [Consulta de Sanções por CPF ou CNPJ](https://apify.com/brasildados/consulta-sancoes-cpf-cnpj-ceis-cnep-cepim-ceaf?fpr=t5lwzq) | Consulte registros públicos de sanções |

# Actor input Schema

## `palavraChave` (type: `string`):

Produto, serviço ou tema no objeto da licitação. Deixe vazio para os mais recentes.

## `uf` (type: `string`):

Um estado brasileiro. Deixe vazio para todo o Brasil.

## `modalidade` (type: `string`):

Modalidade de contratação. Deixe vazio para todas as modalidades.

## `esfera` (type: `string`):

Federal, estadual ou municipal. Deixe vazio para todas as esferas.

## `maxResultados` (type: `integer`):

Quantidade máxima de editais (1–5.000). Cobrado apenas por editais entregues.

## Actor input object example

```json
{
  "palavraChave": "software",
  "uf": "SP",
  "modalidade": "Pregão Eletrônico",
  "esfera": "Estadual",
  "maxResultados": 200
}
```

# Actor output Schema

## `resultados` (type: `string`):

Itens do Dataset desta execução.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "palavraChave": "software",
    "uf": "SP",
    "modalidade": "Pregão Eletrônico",
    "esfera": "Estadual",
    "maxResultados": 200
};

// Run the Actor and wait for it to finish
const run = await client.actor("brasildados/editais-licitacoes-brasil").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "palavraChave": "software",
    "uf": "SP",
    "modalidade": "Pregão Eletrônico",
    "esfera": "Estadual",
    "maxResultados": 200,
}

# Run the Actor and wait for it to finish
run = client.actor("brasildados/editais-licitacoes-brasil").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "palavraChave": "software",
  "uf": "SP",
  "modalidade": "Pregão Eletrônico",
  "esfera": "Estadual",
  "maxResultados": 200
}' |
apify call brasildados/editais-licitacoes-brasil --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,brasildados/editais-licitacoes-brasil"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/qJifOALVu3OlD0G25/builds/SfNk4JENjkdV1dav4/openapi.json