# Editais e Licitações do Brasil (`brasildados/editais-licitacoes-brasil`) Actor Busque editais de licitações abertos no Brasil por palavra-chave, UF, modalidade e esfera de governo (Federal, Estadual, Municipal). Resultados em JSON ou via API REST (Standby). Pronto para lead generation, inteligência de mercado e monitoramento de oportunidades públicas. - **URL**: https://apify.com/brasildados/editais-licitacoes-brasil.md - **Developed by:** [BrasilDados.org](https://apify.com/brasildados) (community) - **Categories:** Lead generation, Other, Integrations - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 edital retornados This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Editais e Licitações do Brasil Busque **editais de licitação abertos** publicados por órgãos públicos brasileiros — Federais, Estaduais e Municipais — filtrando por palavra-chave, UF, modalidade e esfera de governo. Para cada edital, receba objeto, datas de abertura e fechamento da proposta, valor estimado, órgão responsável (com CNPJ, unidade administrativa, esfera e poder) e localização. Disponível em duas formas de uso: - **Execução tradicional** (job): rode com seus filtros e baixe o dataset (JSON, CSV, Excel, XML). - **API REST (Standby)**: envie `POST /search` com o JSON de filtros e receba a lista de editais na resposta — pronto para integrar em CRM, dashboard ou pipeline próprio. ### Para quem é - **Fornecedores do setor público** que querem encontrar oportunidades onde vender (lead generation). - **Equipes de inteligência de mercado** que monitoram o que cada órgão está comprando, por região e modalidade. - **Consultorias jurídicas e tributárias** que acompanham editais por palavras-chave para clientes. - **Plataformas de licitação e marketplaces** que precisam ingerir editais abertos em tempo real. ### Diferenciais - Identificador opaco por edital (`bd-XXXXXXXXXXXX`) seguro para uso como chave estável na sua base. - Objeto da licitação **limpo de prefixos de sistemas de origem** (`[LICITANET]`, `[Portal de Compras Públicas]`, `[Betha]`, etc) que poluem a busca. - Datas normalizadas em ISO 8601, valor como número (não string com vírgula), `aberto` pré-calculado e `diasAteFechamento` pronto para alertas. - Hierarquia administrativa achatada: órgão, unidade, esfera e poder em campos diretos e nomeados. - Cobertura nacional: editais Federais + Estaduais + Municipais no mesmo dataset. - Paginação automática até o limite que você definir, com proteção contra fatura surpresa. ### Casos de uso - **Lead gen para fornecedores**: monte uma busca por palavra-chave (ex: `software`, `merenda escolar`, `coleta de resíduos`) e descubra editais abertos em todo o país. - **Monitor diário**: agende execuções recorrentes para capturar novas oportunidades assim que publicadas. - **Mapeamento de mercado**: analise editais por UF, modalidade e esfera para entender concentração de compras públicas em um setor. - **Alertas inteligentes**: integre via API REST para disparar notificações em Slack, e-mail ou CRM sempre que aparecer um edital relevante. ### Input ```json { "palavraChave": "software", "uf": "SP", "modalidade": "Pregão Eletrônico", "esfera": "Estadual", "maxResultados": 500 } ```` | Campo | Tipo | Default | Descrição | |-------|------|---------|-----------| | `palavraChave` | string | — | Busca livre no objeto da licitação. Aceita múltiplas palavras. Vazio = sem filtro de texto. | | `uf` | string | todas | Uma UF (sigla, ex: `SP`). Vazio = todas as 27. Para buscar em várias UFs, rode o actor uma vez por UF. | | `modalidade` | string | todas | Uma modalidade de contratação (rótulo em pt-BR). Vazio = todas. | | `esfera` | string | todas | `Federal`, `Estadual` ou `Municipal`. Vazio = todas. | | `maxResultados` | integer | 500 | Limite de editais retornados (1 a 5000). Cada edital custa $0.002. | **Modalidades aceitas**: `Leilão Eletrônico`, `Diálogo Competitivo`, `Concorrência Eletrônica`, `Concorrência Presencial`, `Pregão Presencial`, `Pregão Eletrônico`, `Dispensa`, `Inexigibilidade`, `Manifestação de Interesse`, `Pré-Qualificação`, `Credenciamento`, `Leilão Presencial`, `Concurso`, `Adesão à Ata de Registro de Preços`. ### Output Um registro por edital no dataset padrão: ```json { "referencia": "bd-a1b2c3d4e5f6", "referenciaOficial": "11512469000126-1-000003/2026", "titulo": "Edital nº 90025/2026", "objeto": "Contratação de solução integrada de software de gestão pública (ERP), em ambiente de computação em nuvem.", "tipoInstrumento": "Edital", "modalidade": "Pregão - Eletrônico", "situacao": "Divulgada no PNCP", "aberto": true, "cancelado": false, "valorEstimado": 1063860.0, "propostaAbreEm": "2026-05-22T00:00:00", "propostaFechaEm": "2026-06-15T23:59:59", "diasAteFechamento": 22, "publicadoEm": "2026-05-22T23:26:18", "atualizadoEm": "2026-05-23T19:38:04", "numero": "90025", "ano": "2026", "numeroSequencial": "3", "orgao": { "cnpj": "11512469000126", "cnpjFormatado": "11.512.469/0001-26", "nome": "MUNICIPIO DE SULINA", "subrogado": null }, "unidade": { "codigo": "3316", "nome": "PREFEITURA MUNICIPAL DE SULINA" }, "governo": { "esfera": "Municipal", "poder": "Executivo" }, "local": { "uf": "PR", "municipio": "Sulina" }, "fonteOrcamentaria": null, "exigeConteudoNacional": false, "permiteAdesao": null, "possuiEmendaParlamentar": null, "margemPreferencia": null, "consultadoEm": "2026-05-24T03:30:00.000Z" } ``` #### Campos principais | Campo | Descrição | |-------|-----------| | `referencia` | Identificador interno opaco e estável. | | `referenciaOficial` | Identificador oficial do edital (formato CNPJ-seq-numero/ano). | | `objeto` | Descrição do objeto, com prefixos de sistemas de origem removidos. | | `aberto` | True se a janela de propostas ainda está aberta na hora da consulta. | | `diasAteFechamento` | Dias até o encerramento da janela de propostas. | | `orgao`, `unidade`, `governo`, `local` | Hierarquia administrativa e geográfica do órgão. | ### Uso via API REST (Standby) Quando o actor está em modo Standby, você expõe um endpoint REST para integração direta. ```bash curl -X POST \ -H "Authorization: Bearer SEU_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -H "Accept-Encoding: gzip" \ --compressed \ -d '{"palavraChave":"merenda escolar","uf":"SP","maxResultados":100}' \ "https://brasildados--editais-licitacoes-brasil.apify.actor/search" ``` A documentação interativa (Swagger UI) fica na aba **Standby** do actor no Apify Console. ### Pricing `$0,002` por edital retornado. Exemplos: | Busca | Editais | Custo | |-------|---------|-------| | Triagem rápida (`maxResultados: 50`) | 50 | $0,10 | | Busca padrão (default) | 500 | $1,00 | | Varredura ampla (`maxResultados: 2000`) | 2000 | $4,00 | Use `maxResultados` para controlar o gasto. Resultados exportáveis em JSON, CSV, Excel ou XML diretamente pela Apify. ### Cobertura Operamos sobre o **repositório oficial nacional de contratações públicas** instituído pela **Lei 14.133/2021 (Nova Lei de Licitações e Contratos)**, que centraliza editais publicados por entes da União, Estados, Distrito Federal e Municípios — tanto da administração direta quanto autárquica e fundacional. Não é necessário cadastro ou chave de acesso adicional do usuário. Por padrão, retornamos apenas editais com **janela de propostas em aberto** (`situacao = recebendo proposta`). Editais já encerrados, homologados, anulados ou revogados não entram nesta busca. *** ### Brazilian Public Tenders & Bids (English) Search **open Brazilian government tenders** published by Federal, State and Municipal agencies — filtered by keyword, state, modality and government sphere. For each tender, get subject, proposal opening and closing dates, estimated value, responsible agency (CNPJ, administrative unit, sphere, branch) and geographic location. Available in two modes: - **Traditional run** (job): pass filters, download the dataset (JSON, CSV, Excel, XML). - **REST API (Standby)**: send `POST /search` with the JSON filters and get the tender list in the response — ready for CRM, dashboard or custom pipeline integration. #### Who is it for - **Public-sector suppliers** looking for sales opportunities (lead generation). - **Market intelligence teams** monitoring agency procurement patterns by region and modality. - **Legal/tax consultancies** tracking tenders by keyword on behalf of clients. - **Tender platforms / marketplaces** ingesting open tenders in real time. #### Highlights - Opaque, stable per-record reference (`bd-XXXXXXXXXXXX`) safe as a foreign key. - Tender subject **cleaned of source-system prefixes** (`[LICITANET]`, `[Portal de Compras Públicas]`, `[Betha]`, etc). - Dates normalized to ISO 8601, value as number (not BR-locale string), pre-computed `aberto` flag and `diasAteFechamento` ready for alerts. - Flattened administrative hierarchy: agency, unit, sphere and branch in direct named fields. - National coverage: Federal + State + Municipal tenders in a single dataset. - Automatic pagination up to your defined cap, with bill-shock protection. #### Use cases - **Lead gen for suppliers**: keyword-search open tenders countrywide (e.g. `software`, `school meals`, `waste collection`). - **Daily monitor**: schedule recurring runs to catch new tenders as soon as they go live. - **Market mapping**: analyze tenders by state, modality and sphere to map public-procurement concentration in a sector. - **Smart alerts**: integrate via REST API to push Slack/email/CRM notifications when a relevant tender appears. #### Pricing `$0.002` per tender returned. A typical 500-tender run costs `$1.00`. Export results in JSON, CSV, Excel or XML directly from Apify. #### Coverage We operate on the **official national repository of public procurement** established by **Brazilian Federal Law 14.133/2021 (New Public Procurement Act)**, which centralizes tenders published by federal, state, district and municipal entities — direct, autonomous and foundational administration. No additional registration or API key required from the end user. By default, only tenders **currently accepting proposals** are returned. Closed, awarded, cancelled or revoked tenders are out of scope of this Actor. ### Pipeline / Actors relacionados Combine com os demais actors **brasildados** para inteligência completa de licitações: | Actor | Quando usar no pipeline | |-------|------------------------| | [Government Contracts Check](https://apify.com/brasildados/government-contracts-check) | Pesquise o histórico de contratos dos concorrentes ou de empresas que já venceram no setor | | [CNPJ Enrichment & Lead Search](https://apify.com/brasildados/cnpj-enrichment-lead-search) | Enriqueça os CNPJs dos órgãos contratantes ou de concorrentes com dados cadastrais e sócios | | [Brazil Sanctions Check](https://apify.com/brasildados/sanctions-check) | Verifique se concorrentes estão em CEIS/CNEP — impedidos de contratar com o poder público | | [DOU Monitor](https://apify.com/brasildados/dou-monitor) | Monitore publicações complementares (extratos, atas, adjudicações) no Diário Oficial da União | **Exemplo de pipeline de inteligência competitiva:** editais → government contracts dos concorrentes → sanctions check → enrichment dos vencedores. # Actor input Schema ## `palavraChave` (type: `string`): Busca livre no objeto da licitação. Aceita várias palavras separadas por espaço. Deixe vazio para listar todos os editais abertos. | Free-text search in the tender subject. Leave empty to list all open tenders. ## `uf` (type: `string`): Filtre por uma unidade federativa. Deixe vazio para todas. | Filter by one Brazilian state. Empty = all 27. ## `modalidade` (type: `string`): Filtre por modalidade de contratação. Deixe vazio para todas. | Filter by procurement modality. Empty = all. ## `esfera` (type: `string`): Filtre pela esfera de governo. Deixe vazio para todas. | Filter by government sphere. Empty = all. ## `maxResultados` (type: `integer`): Limite de editais retornados. Controle direto sobre o custo: você é cobrado por edital retornado ($0.002 cada). Default 500. | Cap on tenders returned. Direct cost control: charged per tender returned ($0.002 each). Default 500. ## Actor input object example ```json { "palavraChave": "software", "uf": "SP", "modalidade": "Pregão Eletrônico", "maxResultados": 500 } ``` # Actor output Schema ## `results` (type: `string`): Dataset com um registro por edital retornado. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "palavraChave": "software", "uf": "SP", "modalidade": "Pregão Eletrônico" }; // 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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "palavraChave": "software", "uf": "SP", "modalidade": "Pregão Eletrônico", } # 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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" }' | apify call brasildados/editais-licitacoes-brasil --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=brasildados/editais-licitacoes-brasil", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Editais e Licitações do Brasil", "description": "Busque editais de licitações abertos no Brasil por palavra-chave, UF, modalidade e esfera de governo (Federal, Estadual, Municipal). Resultados em JSON ou via API REST (Standby). Pronto para lead generation, inteligência de mercado e monitoramento de oportunidades públicas.", "version": "1.0", "x-build-id": "QuspfCn1Wtkir21T3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brasildados~editais-licitacoes-brasil/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brasildados-editais-licitacoes-brasil", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/brasildados~editais-licitacoes-brasil/runs": { "post": { "operationId": "runs-sync-brasildados-editais-licitacoes-brasil", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/brasildados~editais-licitacoes-brasil/run-sync": { "post": { "operationId": "run-sync-brasildados-editais-licitacoes-brasil", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "palavraChave": { "title": "Palavra-chave", "type": "string", "description": "Busca livre no objeto da licitação. Aceita várias palavras separadas por espaço. Deixe vazio para listar todos os editais abertos. | Free-text search in the tender subject. Leave empty to list all open tenders." }, "uf": { "title": "UF", "enum": [ "AC", "AL", "AP", "AM", "BA", "CE", "DF", "ES", "GO", "MA", "MT", "MS", "MG", "PA", "PB", "PR", "PE", "PI", "RJ", "RN", "RS", "RO", "RR", "SC", "SP", "SE", "TO" ], "type": "string", "description": "Filtre por uma unidade federativa. Deixe vazio para todas. | Filter by one Brazilian state. Empty = all 27." }, "modalidade": { "title": "Modalidade", "enum": [ "Leilão Eletrônico", "Diálogo Competitivo", "Concorrência Eletrônica", "Concorrência Presencial", "Pregão Presencial", "Pregão Eletrônico", "Dispensa", "Inexigibilidade", "Manifestação de Interesse", "Pré-Qualificação", "Credenciamento", "Leilão Presencial", "Concurso", "Adesão à Ata de Registro de Preços" ], "type": "string", "description": "Filtre por modalidade de contratação. Deixe vazio para todas. | Filter by procurement modality. Empty = all." }, "esfera": { "title": "Esfera", "enum": [ "Federal", "Estadual", "Municipal" ], "type": "string", "description": "Filtre pela esfera de governo. Deixe vazio para todas. | Filter by government sphere. Empty = all." }, "maxResultados": { "title": "Máximo de resultados", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Limite de editais retornados. Controle direto sobre o custo: você é cobrado por edital retornado ($0.002 cada). Default 500. | Cap on tenders returned. Direct cost control: charged per tender returned ($0.002 each). Default 500.", "default": 500 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```