# Brazil Tenders Scraper: PNCP Licitações to Excel (`tenderfeed/brazil-pncp-tenders`) Actor Scrape Brazilian public tenders (licitações, editais, dispensas) from PNCP, the official national portal, via its open API, no key. Federal, state and municipal buyers. Filter by keyword, modality, state, city, value, open deadline. "Only new" daily alerts. Excel, CSV, JSON. - **URL**: https://apify.com/tenderfeed/brazil-pncp-tenders.md - **Developed by:** [TenderFeed](https://apify.com/tenderfeed) (community) - **Categories:** Lead generation, Automation - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Brazil Tenders Scraper: PNCP Licitações to Excel **Export Brazilian public tenders (licitações) from PNCP to Excel, CSV or JSON, with no API key.** Since the new procurement law (Lei 14.133/2021), every federal, state and municipal buyer in Brazil must publish its procurements on the **Portal Nacional de Contratações Públicas (PNCP)**. This Actor reads them from PNCP's **official open-data API** and returns one clean row per notice: object (objeto), buyer and CNPJ, city and state, modality, estimated value in BRL, proposal opening and closing dates, the link to the bidding system and, optionally, the edital and annex download links. On a normal business day PNCP publishes **~300 Pregão Eletrônico, ~90 Concorrência Eletrônica and ~900 Dispensa notices** (measured 2026-10-30). Schedule **"only new"** for daily licitação alerts. Built by **TenderFeed** ([apify.com/tenderfeed](https://apify.com/tenderfeed)). No login, no browser, no HTML scraping. ### What can you do with it? - **Licitação alerts**: open Pregões and Concorrências in your segment, state or city, with the proposal deadline and the link to Compras.gov.br / the buyer's platform. - **Dispensa eletrônica opportunities**: small-value direct purchases with a short proposal window, ideal for small suppliers (`modalities: ["8"]`). - **Market intelligence**: who buys what, where and for how much, across 5,000+ municipalities, states and federal bodies. - **Bid consultancies and grant/tender writers**: feed a CRM or spreadsheet with every new edital for your clients. - **AI agents**: use it as an **MCP tool** (Apify MCP server) and ask *"Which municipalities in Rio Grande do Norte opened software tenders this week?"* ### Input example ```json { "keywords": ["software", "sistema de gestão"], "modalities": ["6", "4"], "states": ["RN", "PB", "PE"], "publishedFrom": "7 days", "onlyOpen": true, "minValue": 50000, "includeDocuments": true, "maxResults": 0 } ``` - `modalities` (PNCP codes): 6 Pregão Eletrônico, 4 Concorrência Eletrônica, 8 Dispensa, 9 Inexigibilidade, 12 Credenciamento, 1 Leilão Eletrônico, 3 Concurso, 15 Chamada pública, 18 Pregão Eletrônico Internacional and more. Empty = 6, 4 and 8. - `keywords` match the object and complementary information, accent-insensitive (`licitacao` = `licitação`). - `states` (UF), `cities`, `spheres` (F federal, E state, M municipal, D district), `buyerName`, `buyerCnpj` narrow the buyer. - `minValue` / `maxValue` (BRL) apply to the estimated value (`valorTotalEstimado`). - `onlyOpen` keeps active notices whose proposal deadline is still in the future. - Default run: last 2 days, newest day first, 50 results. ### Output example Real row from a live run on 2026-11-03: ```json { "source": "br-pncp", "sourceId": "08241788000130-1-000123/2026", "url": "https://pncp.gov.br/app/editais/08241788000130/2026/123", "title": "Contratação de empresa especializada para prestação de serviço continuado de Tecnologia da Informação e Comunicação (TIC), ... Software as a Service (SaaS) ...", "noticeType": "Edital", "status": "active", "procedureType": "Pregão - Eletrônico", "buyerName": "RIO GRANDE DO NORTE SECRETARIA DA ADMINISTRACAO", "buyerCnpj": "08241788000130", "buyerCity": "Natal", "state": "RN", "sphere": "state", "publishedAt": "2026-10-29T13:46:13", "proposalsOpenAt": "2026-11-03T08:00:00", "deadlineAt": "2026-11-18T10:00:00", "estimatedValue": 3020500.2, "currency": "BRL", "submissionUrl": "https://cnetmobile.estaleiro.serpro.gov.br/comprasnet-web/public/compras/acompanhamento-compra?compra=92553805002322026", "legalBasis": "Lei 14.133/2021, Art. 28, I – pregão: ...", "disputeMode": "Aberto", "priceRegistration": false } ``` Other fields: `description` (object + complementary information), `buyerUnit`, `buyerUnitCode`, `power`, `modalityId`, `processNumber`, `purchaseNumber`, `purchaseYear`, `pncpStatus`, `awardedValue` (homologated value, when published), `documentsUrl` (PNCP files API) and, with `includeDocuments`, `documents` (title, type, download URL of the edital, termo de referência and annexes). Times are Brasília local time. #### Field coverage (live test, default input, 50 notices published 2026-11-03) Title, buyer, city, state, modality, published date, proposal deadline, estimated value, PNCP link: 50/50. Bidding-system link: 49/50. The data follows the same normalized schema as our other TenderFeed Actors ([EU TED](https://apify.com/tenderfeed/ted-eu-tenders), [SAM.gov](https://apify.com/tenderfeed/sam-gov-opportunities), [UK](https://apify.com/tenderfeed/uk-tenders), [Grants.gov](https://apify.com/tenderfeed/grants-gov-us), [USAspending](https://apify.com/tenderfeed/usaspending-contract-awards)). ### Daily alerts ("only new" monitoring mode) Turn on `onlyNew`, set a `monitoringId` (for example `"rn-software"`) and schedule the Actor daily. Each run returns, and charges for, only notices you have not received yet. In our test, a second identical run skipped the 5 notices delivered by the first and returned 5 different ones. ### Sample output (real run) One row from a run on 6 November 2026 (core columns only; every row also has description, status, procedureType, documentsUrl and more). Contact values are masked here. Since schema 1.2 every row also carries the cross-source columns `country`, `deadline`, `valueAmount`, `valueCurrency` and `cpvOrNaics` next to the original ones (`buyerCountry`, `deadlineAt`, `estimatedValue`, `currency`, `cpvCodes`/`naicsCodes`), which are unchanged. ```json { "title": "Contratação de empresa especializada na prestação de serviços de tecnologia da informação para a concessão de direito de uso (locação) de...", "source": "br-pncp", "country": "BR", "noticeType": "Edital", "publishedAt": "2026-11-05T08:09:12", "deadline": "2026-11-23T08:59:00", "buyerName": "MUNICIPIO DE VARZEA PAULISTA", "valueAmount": 5085361.66, "valueCurrency": "BRL", "cpvOrNaics": null, "setAside": null, "url": "https://pncp.gov.br/app/editais/45780087000103/2026/129", "buyerContactName": null, "buyerContactEmail": null, "buyerContactPhone": null } ``` ### Limits and notes - **Data source:** PNCP (Portal Nacional de Contratações Públicas) public API. - **Access:** No login or API key. - **Delays and gaps:** Notices are in Portuguese. The PNCP API can be slow or return intermittent errors; the Actor retries. Estimated value is as declared by the buyer (BRL). - **Contacts:** No buyer contact persons are extracted. - Fields the portal does not publish stay `null`; nothing is guessed or filled in. ### Pricing Pay per result: you pay only for the notices saved to the dataset (see the price on this page), plus Apify's small run-start fee. The default run takes a few seconds. ### More TenderFeed sources Same output schema across all sources, so you can merge results in one sheet or CRM: - [EU TED tenders](https://apify.com/tenderfeed/ted-eu-tenders) - [SAM.gov federal contract opportunities](https://apify.com/tenderfeed/sam-gov-opportunities) - [Grants.gov US federal grants](https://apify.com/tenderfeed/grants-gov-us) - [USAspending federal contract awards](https://apify.com/tenderfeed/usaspending-contract-awards) - [UK Find a Tender + Contracts Finder](https://apify.com/tenderfeed/uk-tenders) - [France BOAMP appels d'offres](https://apify.com/tenderfeed/france-boamp-tenders) - [Switzerland SIMAP tenders](https://apify.com/tenderfeed/switzerland-simap-tenders) - [World Bank procurement notices & awards](https://apify.com/tenderfeed/world-bank-procurement) - [Poland BZP e-Zamówienia tenders](https://apify.com/tenderfeed/poland-bzp-tenders) - [Ukraine Prozorro tenders](https://apify.com/tenderfeed/ukraine-prozorro-tenders) - [AusTender Australian government contracts](https://apify.com/tenderfeed/australia-austender-contracts) - [EU Funding & Tenders Portal grants and calls](https://apify.com/tenderfeed/eu-funding-tenders-portal) - [CanadaBuys tenders and awards](https://apify.com/tenderfeed/canada-canadabuys-tenders) - [Germany public tenders (Ausschreibungen)](https://apify.com/tenderfeed/germany-public-tenders) - [NYC City Record bids & awards](https://apify.com/tenderfeed/nyc-city-record-procurement) - [Colombia SECOP II licitaciones](https://apify.com/tenderfeed/colombia-secop-tenders) - [Netherlands TenderNed aanbestedingen](https://apify.com/tenderfeed/netherlands-tenderned-tenders) ### FAQ **Is this official data?** Yes. It comes from the PNCP open-data API (`pncp.gov.br/api/consulta`), maintained by the Brazilian federal government under Lei 14.133/2021 (art. 174). No personal contact data is published there. **Where do I submit a proposal?** On the bidding system shown in `submissionUrl` (Compras.gov.br or the buyer's own platform). PNCP itself is the publication portal. **Does it cover old notices under Lei 8.666?** Only those the buyers published on PNCP. Coverage is complete for Lei 14.133 procurements. **Something missing?** Open an issue on the Actor page. TenderFeed answers within one business day. # Actor input Schema ## `keywords` (type: `array`): Words to look for in the object (objeto) and complementary information, accent-insensitive, e.g. \["software", "limpeza", "pavimentação"]. Empty = all notices. ## `keywordMode` (type: `string`): Match ANY or ALL keywords. ## `modalities` (type: `array`): PNCP procurement modalities. Empty = Pregão Eletrônico, Concorrência Eletrônica and Dispensa (the main opportunities for suppliers). ## `states` (type: `array`): Buyer state. Empty = all of Brazil. ## `cities` (type: `array`): Exact buyer city names, accent-insensitive, e.g. \["Natal", "São Paulo"]. ## `spheres` (type: `array`): Empty = all. ## `buyerName` (type: `string`): Buyer organization or unit name contains (accent-insensitive), e.g. "universidade", "saúde". ## `buyerCnpj` (type: `string`): Only notices of one buyer organization (14-digit CNPJ, punctuation allowed). ## `publishedFrom` (type: `string`): YYYY-MM-DD or relative ("7 days"). Default: 2 days ago. Newest days are read first. ## `publishedTo` (type: `string`): YYYY-MM-DD. Default: today. ## `onlyOpen` (type: `boolean`): Keep only active notices whose proposal deadline (dataEncerramentoProposta) is still in the future. ## `minValue` (type: `integer`): Applied to valorTotalEstimado. ## `maxValue` (type: `integer`): Applied to valorTotalEstimado. ## `includeUnknownValue` (type: `boolean`): Keep notices with a confidential or missing estimate when a value filter is set. ## `maxResults` (type: `integer`): 0 = no limit. Default 50. PNCP publishes roughly 1,300+ Pregão/Concorrência/Dispensa notices per business day. ## `includeDocuments` (type: `boolean`): One extra API call per notice: adds `documents` with title, type and download URL of each file (edital, termo de referência...). ## `onlyNew` (type: `boolean`): Remember what earlier runs delivered and return (and charge for) only notices you have not received yet. Ideal for scheduled daily alerts. ## `monitoringId` (type: `string`): Name of the watch-list memory used by 'Only new'. Use a different ID per saved search/schedule. ## `includeRawData` (type: `boolean`): Adds the full PNCP API record under `raw` (bigger output). ## Actor input object example ```json { "keywordMode": "any", "onlyOpen": false, "includeUnknownValue": true, "maxResults": 20, "includeDocuments": false, "onlyNew": false, "includeRawData": false } ``` # Actor output Schema ## `results` (type: `string`): All normalized records from the default dataset, opened in the Overview view. # 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 = { "maxResults": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("tenderfeed/brazil-pncp-tenders").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 = { "maxResults": 20 } # Run the Actor and wait for it to finish run = client.actor("tenderfeed/brazil-pncp-tenders").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 '{ "maxResults": 20 }' | apify call tenderfeed/brazil-pncp-tenders --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,tenderfeed/brazil-pncp-tenders" } } } ``` 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 ` 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/m8GmiU31r9ZtTA5S4/builds/7hazJkLKqHaY0fB5L/openapi.json