# Brazil Public Works & Construction Tenders (PNCP) (`nickolss/brazil-public-works-tenders`) Actor

Open Brazilian construction and engineering tenders from the official PNCP portal, filtered and delivered as clean JSON.

- **URL**: https://apify.com/nickolss/brazil-public-works-tenders.md
- **Developed by:** [Nickolas Maia de Araujo](https://apify.com/nickolss) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 tender 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 Public Works & Construction Tenders (PNCP)

Find open **Brazilian government construction tenders** as clean JSON: road paving, sanitation, bridges, school and hospital buildings, renovations and engineering design contracts, from every state and city that publishes on PNCP.

The data comes from **PNCP (Portal Nacional de Contratações Públicas)**, Brazil's official national procurement portal. This Actor reads the open procurement notices, keeps the ones about public works, sorts them into categories and drops what a works contractor does not need: supplies, equipment purchases, rentals, advertising, concessions and tenders that were annulled, revoked or suspended.

**Em português:** licitações abertas de obras públicas e serviços de engenharia do PNCP, filtradas por estado, tipo de obra e valor estimado. Pavimentação, saneamento, pontes, construção e reforma de prédios públicos e projetos de engenharia.

### Who uses it

- **Construction and engineering companies** looking for new public works bids in their region.
- **Bid consultants and tender monitoring services** that need a daily feed of new construction tenders.
- **Suppliers and subcontractors** who want to know which cities are about to start paving or building.
- **Market researchers** who track public infrastructure spending in Brazil.

### What you get

Each result is one open tender:

| Field | Meaning |
|---|---|
| `id` | PNCP control number, stable across runs |
| `status` | PNCP status at run time; only published (open) tenders are returned |
| `categories` | One or more of: `paving`, `sanitation`, `infrastructure`, `renovation`, `building`, `maintenance`, `engineering_services`, `general_works` |
| `description` | Tender object, in Portuguese as published |
| `estimated_value_brl` | Estimated value in BRL; empty when the buyer did not publish it |
| `value_needs_review` | True when the value is unusually high and worth checking |
| `state`, `city`, `buyer` | Where the work is and which public body is buying |
| `modality` | Procurement modality (for example, Concorrência or Pregão) |
| `published_at`, `proposals_open_at`, `proposals_close_at` | Key dates, including the bid deadline |
| `pncp_url`, `source_url` | Links to the official notice |

Example:

```json
{
  "categories": ["paving", "general_works"],
  "description": "Execução de obra de pavimentação asfáltica em CBUQ de vias urbanas",
  "estimated_value_brl": 1250000.0,
  "state": "PR",
  "city": "Pinhais",
  "buyer": "Município de Pinhais",
  "proposals_close_at": "2026-11-28T10:00:00",
  "pncp_url": "https://pncp.gov.br/app/editais/..."
}
```

### Categories

| Category | Typical tenders |
|---|---|
| `paving` | Asphalt paving, resurfacing, interlocking pavers, curbs |
| `sanitation` | Sewage and water networks, drainage, treatment plants, wells |
| `infrastructure` | Bridges, viaducts, rural roads, earthworks, retaining walls, road improvements |
| `building` | New schools, day care centers, health units, sports courts, public buildings |
| `renovation` | Renovation, expansion and repair of public buildings, roofs and facilities |
| `maintenance` | Building maintenance, accessibility, fire safety upgrades, waterproofing |
| `engineering_services` | Design (basic and executive projects), site supervision, surveys, soil tests |
| `general_works` | Any public works tender; use it to get everything |

### Input

```json
{"states": ["SP", "MG"], "categories": ["paving", "sanitation"], "minValueBrl": 500000, "maxResults": 100}
```

- `states`: two-letter state codes (SP, RJ, MG, PR, RS, SC, BA...). Leave empty for all of Brazil.
- `categories`: any of the categories above. Leave empty for all public works.
- `minValueBrl` and `maxValueBrl`: estimated value range in BRL.
- `maxResults`: how many tenders to return.

Ready-made tasks for common searches (by state and by type of work) are listed on this Actor's page.

### FAQ

**How fresh is the data?** Each run reads PNCP live, so you get the tenders that are open at that moment. Schedule the Actor daily to catch new ones.

**Does it cover every tender in Brazil?** No. It covers what is published on PNCP, which is mandatory under Law 14.133/2021 but not yet complete for every city.

**Can foreign companies bid?** Some tenders allow it, but most require a Brazilian legal entity or a local partner. This is data, not legal advice.

**How accurate are the categories?** They come from keyword rules on the tender description, so a few tenders can land in the wrong category. Always read the official notice before bidding.

**Is this affiliated with the Brazilian government?** No. It uses public data from PNCP.

# Actor input Schema

## `states` (type: `array`):

Two-letter UF codes, e.g. SP, RJ. Empty means all.

## `categories` (type: `array`):

paving, sanitation, infrastructure, renovation, building, maintenance, engineering_services, general_works. Empty means all.

## `minValueBrl` (type: `integer`):

Tenders with no published value are kept.

## `maxValueBrl` (type: `integer`):

Tenders with no published value are kept.

## `maxResults` (type: `integer`):

You pay per result returned.

## `maxPagesPerModality` (type: `integer`):

Leave empty to keep searching until Maximum results is reached. Set a number to cap each modality at that many pages of 50 raw tenders, for faster runs.

## Actor input object example

```json
{
  "states": [],
  "categories": [],
  "maxResults": 100
}
```

# Actor output Schema

## `results` (type: `string`):

Open Brazilian construction and engineering tenders, as dataset items.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("nickolss/brazil-public-works-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("nickolss/brazil-public-works-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 '{}' |
apify call nickolss/brazil-public-works-tenders --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nickolss/brazil-public-works-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 <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/4R5dUZaszTXAYRZLr/builds/MDJjzroDpuPgh8T73/openapi.json
