# Public Tenders and Procurement Data API: Tendios (`nabeelbaghoor/public-tenders-procurement-data-api`) Actor

Public tenders and government procurement data API for Spain and the EU: search tenders by CPV, location, status, budget and dates, plus documents, bidders, buyer contacts, awards, alert results and CPV codes, through the Tendios API. Bring your own key.

- **URL**: https://apify.com/nabeelbaghoor/public-tenders-procurement-data-api.md
- **Developed by:** [Nabeel Hassan](https://apify.com/nabeelbaghoor) (community)
- **Categories:** Business, Lead generation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 tender or awarded contracts

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

## Public Tenders and Procurement Data API: Tendios

Search public tenders and government procurement data for Spain and the European Union, with tender documents, bidders, buyer contacts, award statistics and CPV codes, from Tendios with your own key, as clean rows you can export to CSV, Excel or JSON.

Tendios is a public procurement platform from Barcelona that aggregates public tenders from Spanish and European procurement databases, including PLACE (the Plataforma de Contratación del Sector Público). This actor wraps the read endpoints of the Tendios API: tender search with CPV, location, status, budget and date filters, tender detail with lots, buyer and winner, attached documents (pliegos and annexes), PLACE clarifications, the companies that bid and who won, contracting body contacts, organization profiles, yearly award statistics for buyers and suppliers, market awards, your saved alerts and their matching tenders, and CPV code names. Use it for bid and tender monitoring, sales prospecting to public sector buyers, competitor and win-rate analysis, market sizing, procurement BI pipelines and CRM enrichment. Bring your own API key.

BYOK, not live tested: every route, parameter and response field comes from Tendios's own API documentation (developers.tendios.com and the OpenAPI document at api-rest.tendios.com/openapi.json), and the routes were probed on 2026-11-01 with an invalid key. The actor has not been run against a live Tendios key.

### What it does

- **Tender search**: public tenders by keyword, CPV codes, country or town, status (Publicada, Adjudicada, Formalizada and every other documented value), procedure, contract type, budget range, publication, deadline and award dates, open-for-bids only, minor contracts or tenders with lots, plus any other documented filter (award amount, discount rate, prorated budget, expiration dates) as JSON.
- **Alert results**: the tenders that match one of your saved Tendios alerts, optionally narrowed by keywords and publication dates.
- **Tender detail**: status, procedure, contract type, result, budget without taxes, estimated value, award amount, currency, CPV codes, NUTS location, publication, deadline, award, formalization and expiration dates, buyer and winner with tax IDs, and every lot.
- **Tender documents**: the pliegos (PCAP, PPT), annexes, memorias, award notices and other files attached to a tender, with Tendios document type, date and source URL.
- **Clarifications**: the questions and answers a contracting authority published on PLACE for a tender.
- **Bidders**: the companies that presented to a tender, which of them won, the lots they won and their offers with amount, discount and ranking.
- **Buyer contacts**: emails, names, job titles and phones of the contracting body from DIR3, stored contacts, signatures and tender documents, each marked FOUND or INFERRED.
- **Organization profiles and award statistics**: buyer or supplier profile with tax ID, activity and address, and yearly award counts and amounts by year and sector.
- **Market awards**: contracts awarded to a curated supplier family or by a buyer over a publication or award date range, with totals.
- **Alert list and CPV codes**: the alerts configured on your account, and CPV code names in English, Spanish, French, German, Italian, Catalan and Portuguese.

### How to get your own key

1. API access is part of Tendios Enterprise plans. Contact hello@tendios.com to upgrade or ask for API access.
2. An account admin opens Tendios Bid, Settings, Subscription, Integrations (bid.tendios.com/settings/account/subscription/apikeys) and generates a key. A read-only key is enough for every mode of this actor.
3. Copy the key (it starts with `tend_` and is shown only once) into the **Tendios API key** field, or set it as the `DATA_API_KEY` secret.

### Input

| Field | Used by | Description |
| --- | --- | --- |
| What to read | all | The mode: tender search, alert results, tender detail, documents, clarifications, bidders, contacts, organization profile, award statistics, market awards, alert list or CPV codes |
| Tendios API key | all | Your own `tend_` key |
| Keywords | search, alert results | Free-text query |
| Tender status | search | Documented status values, such as Publicada or Adjudicada |
| CPV codes | search, CPV codes | CPV filter, or the codes to describe |
| Locations | search | country/ES, town/Madrid; a bare two-letter code is a country |
| Procedure types, contract types | search | Values as Tendios returns them, such as Abierto or Servicios |
| Only open for bids, only minor contracts, only tenders with lots | search | Boolean filters |
| Minimum and maximum budget | search | Budget without taxes |
| Published, deadline and awarded from and to | search, alert results, market awards | Date ranges, YYYY-MM-DD |
| Sort tenders by, newest or largest first | search, alert results | Documented sort values and direction |
| Extra search filters | search | Any other documented search field as JSON |
| Tender IDs | tender modes | Tendios tender IDs from a search row |
| Minimum DIR3 relevance | contacts | Threshold for DIR3-only emails (default 30) |
| Organization IDs or slugs | organization modes | Buyer or winner IDs from a tender row, or slugs |
| Alert IDs | alert results | From the alert list mode |
| Alert title contains, alert state, sort alerts by | alert list | Alert list filters |
| Supplier family ID, buyer perimeter ID, buyer organization ID | market awards | Curated scopes shared by Tendios support, or a buyer organization ID |
| Country code, include dependent bodies, include modifications | market awards | Market award options |
| Maximum rows | all | Stop after this many rows (default 100) |
| Requests per minute | all | Pacing ceiling (default 25; Tendios allows 30 per endpoint) |

Example input for open IT tenders in Spain:

```json
{
    "mode": "searchTenders",
    "searchText": "software",
    "cpvCodes": ["72000000-5"],
    "locations": ["country/ES"],
    "statuses": ["Publicada"],
    "onlyWithinDeadline": true,
    "minBudget": 50000,
    "sort": "by-due-date",
    "sortDescending": false,
    "maxResults": 200
}
```

### Output

Every row carries `mode`, `recordType`, `query` and `found`, flat columns for the record type, and the whole provider record in `record`. A tender row looks like this:

```json
{
    "mode": "searchTenders",
    "recordType": "tender",
    "query": "search",
    "found": true,
    "tenderId": "507f1f77bcf86cd799439011",
    "name": "Servicio de mantenimiento de aplicaciones informáticas",
    "status": "Publicada",
    "procedure": "Abierto",
    "contractType": "Servicios",
    "budgetNoTaxes": 180000,
    "awardAmount": null,
    "currency": "EUR",
    "cpvCodes": ["72000000-5"],
    "countryCode": "ES",
    "province": "Barcelona",
    "town": "Barcelona",
    "publishedAt": "2026-10-28T09:00:00.000Z",
    "submissionDeadline": "2026-11-20T14:00:00.000Z",
    "buyerId": "6650a1b2c3d4e5f601234567",
    "buyerName": "Ajuntament de Barcelona",
    "buyerTaxId": "P0801900B",
    "winnerName": null,
    "lotCount": 2,
    "platformUrl": "https://bid.tendios.com/...",
    "record": { "id": "507f1f77bcf86cd799439011", "lots": [] }
}
```

Bidder rows add `organizationId`, `taxId`, `won`, `lotsWonCount`, `offerCount`, `bestDiscountPercentage`, `candidatesCount` and `offersReceived`. Contact rows add `email`, `name`, `jobTitle`, `phone`, `contactStatus` and `sourceTypes`. Award statistics rows add `role`, `firstYear`, `latestYear`, `latestYearCount`, `latestYearAmount`, `totalAwards`, `totalAmount` and `sectorCount`. A lookup Tendios refuses or answers empty becomes one row with `found: false` and a `note`, and is never charged.

### Pricing

Pay per event, only for rows that carry real Tendios data:

| Event | Price |
| --- | --- |
| Tender or awarded contract | $0.01 |
| Bidder, buyer contact or organization profile | $0.01 |
| Organization award statistics | $0.02 |
| Tender document, clarification, alert or CPV code | $0.005 |

Your Tendios plan is billed by Tendios separately.

### FAQ

#### What is the Tendios API?

The Tendios API is the REST API of Tendios S.L., a Barcelona public procurement platform. It gives Enterprise customers programmatic access to public tenders from Spanish and European procurement databases, tender documents, bidders, awards, buyer intelligence and their own alerts and opportunity pipeline.

#### Do I need my own Tendios API key?

Yes. This actor is bring your own key: it calls the Tendios API with your key and never ships one. API access is available on Tendios Enterprise plans; an account admin generates the key in Tendios Bid.

#### Which countries and sources does it cover?

Tendios aggregates tenders from Spanish and European public procurement databases, including PLACE, the Spanish central platform whose clarifications the API also returns. What your key can see depends on the countries and history your Tendios plan includes.

#### Can this actor create alerts or change my pipeline?

No. It only calls GET routes and the three documented read POSTs (tender search, alert results and market awards), which a read-only key can call. Creating or updating alerts, tasks and opportunities is never sent.

#### How do I find who won a public tender?

Use the tender bidders mode with the tender ID: it returns every company Tendios holds as having presented, with `won`, the lots won, and each offer's amount, discount and ranking. Tender detail also carries the winner of the tender and of each lot.

#### How do I search tenders by CPV code?

Put the CPV codes in the CPV codes field of the tender search mode, such as 72000000-5 for IT services or 45000000-7 for construction work. Use the CPV codes mode to get the name of a code in seven languages.

#### Are the contact emails verified?

No. Tendios marks each contact FOUND (observed in a source) or INFERRED (built from a name and an address pattern), and says neither status verifies that the mailbox exists.

#### Where do supplier family and buyer perimeter IDs come from?

They are scopes curated by Tendios. Ask support@tendios.com for the IDs you need. For a single buyer, use the buyer organization ID from a tender row instead.

#### What are the rate limits?

Tendios allows 30 requests a minute per endpoint by default, shared by every key of the account (60 for tender contacts). The actor paces itself at 25 a minute and honours Retry-After on a 429.

### Keyword map

public tenders API, government tenders API, public procurement data, procurement data API, Spain public tenders, licitaciones públicas API, EU tenders, PLACE contratación, CPV code search, tender alerts, contract awards data, bidder and winner data, public sector sales leads, Tendios API.

### Routes and verification

| Mode | Route | Probe with invalid key (twice) |
| --- | --- | --- |
| Tender search | POST /api/v1/tenders/search | 401 {"message":"Invalid api key","error":"Unauthorized"} |
| Tender detail | GET /api/v1/tenders/{id} | 401 |
| Documents, clarifications, bidders, contacts | GET /api/v1/tenders/{id}/sheets, /questions-answers, /candidates, /contacts | same API, same key gate |
| Alert list, alert results | GET /api/v1/alerts, POST /api/v1/alerts/{alertId}/results | same API, same key gate |
| Organization profile, award statistics | GET /api/v1/organizations/{idOrSlug}, /awards | 401 on /awards |
| Market awards | POST /api/v1/market-awards | 401 |
| CPV codes | GET /api/v1/cpv/{code} | 401 |
| Invented control routes | GET /api/v1/tenders/{id}/bidders-list, /api/v1/tender-insights | 404 {"message":"Cannot GET ...","error":"Not Found"} |

Every request sends the key in the documented `api-key` header, never in a URL or a log line. Document file downloads, kanban and opportunity routes and every write route are not wrapped.

### Licensing and data use

This actor works only with your own Tendios key, and your agreement with Tendios applies. The Tendios Terms of Service are for business use, make you responsible for your credentials, and bar scraping, mirroring or bulk-exporting Service content except as expressly permitted, and circumventing rate limits or plan entitlements; they set no cache or retention limit on API results. Use the data for your own procurement, sales and analysis work within your plan, and do not republish it in bulk. The underlying tender data comes from public sources, and the official publications remain authoritative. This actor is not affiliated with or endorsed by Tendios.

# Actor input Schema

## `mode` (type: `string`):

Each mode calls one documented read endpoint of the Tendios API. Search and market awards take filters; tender modes take tender IDs; organization modes take organization IDs or slugs; alert results take alert IDs; the CPV mode takes CPV codes. Nothing is ever written to your Tendios account.

## `apiKey` (type: `string`):

Your own Tendios API key (starts with tend\_). An account admin creates it in Tendios Bid under Settings, Subscription, Integrations; API access is part of Enterprise plans. A read-only key is enough. Leave empty to use the DATA_API_KEY secret.

## `searchText` (type: `string`):

Tender search and alert results. Free-text query, such as limpieza de edificios or software development.

## `statuses` (type: `array`):

Tender search. Publicada is open for bids, Adjudicada awarded, Formalizada contract signed. Leave empty for every status.

## `cpvCodes` (type: `array`):

Tender search: only tenders under these CPV codes. CPV code mode: the codes to describe, such as 72000000 or 45000000-7.

## `locations` (type: `array`):

Tender search. country/<ISO-2> or town/<name>, such as country/ES or town/Barcelona. A bare two-letter code is read as a country, anything else as a town.

## `procedures` (type: `array`):

Tender search. Procedure values as Tendios returns them in the procedure field, such as Abierto, Abierto simplificado or Negociado sin publicidad.

## `contractTypes` (type: `array`):

Tender search. Contract type values as Tendios returns them, such as Servicios, Suministros or Obras.

## `onlyWithinDeadline` (type: `boolean`):

Tender search. Only tenders still within their submission deadline.

## `minorContractsOnly` (type: `boolean`):

Tender search. Only minor contracts (contratos menores).

## `withLotsOnly` (type: `boolean`):

Tender search. Only tenders split into lots.

## `minBudget` (type: `integer`):

Tender search. Minimum budget without taxes, in the tender currency.

## `maxBudget` (type: `integer`):

Tender search. Maximum budget without taxes, in the tender currency.

## `publishedFrom` (type: `string`):

Tender search, alert results and market awards. Earliest publication date, YYYY-MM-DD.

## `publishedTo` (type: `string`):

Tender search, alert results and market awards. Latest publication date, YYYY-MM-DD.

## `deadlineFrom` (type: `string`):

Tender search. Earliest submission deadline, YYYY-MM-DD.

## `deadlineTo` (type: `string`):

Tender search. Latest submission deadline, YYYY-MM-DD.

## `awardedFrom` (type: `string`):

Tender search and market awards. Earliest award date, YYYY-MM-DD.

## `awardedTo` (type: `string`):

Tender search and market awards. Latest award date, YYYY-MM-DD.

## `sort` (type: `string`):

Tender search and alert results. The order tenders come back in.

## `sortDescending` (type: `boolean`):

Sort descending (the default). Turn off for oldest or smallest first. Also sets the direction of the alert list and market awards.

## `extraFilters` (type: `object`):

Tender search. Any other documented Tendios search field as JSON, such as {"minAwardAmount": 100000, "maxDiscountRate": 20, "minExpirationDate": "2027-01-01T00:00:00Z"}. Undocumented fields are refused.

## `tenderIds` (type: `array`):

Tender detail, documents, clarifications, bidders and contacts. Tendios tender IDs, the tenderId column of a search row.

## `minDir3Relevance` (type: `integer`):

Tender contacts. Keep DIR3-only emails whose procurement relevance is above this percentage (Tendios default 30). Emails from other sources are always kept.

## `organizationIds` (type: `array`):

Organization profile and award statistics. A buyer or winner ID from a tender row, or a slug such as altia-consultores-sa. IDs are safer: slugs are not unique.

## `alertIds` (type: `array`):

Alert results. IDs of saved alerts on your Tendios account, from the alert list mode.

## `alertTitle` (type: `string`):

Alert list. Only alerts whose title matches this text.

## `alertState` (type: `string`):

Alert list. Filter archived or non-archived alerts.

## `alertSort` (type: `string`):

Alert list. The order alerts come back in.

## `supplierFamilyId` (type: `string`):

Market awards. A curated Tendios supplier family (a company and its related entities). Tendios support shares these IDs.

## `buyerPerimeterId` (type: `string`):

Market awards. A curated Tendios buyer perimeter. Cannot be combined with a buyer organization ID.

## `buyerOrganizationId` (type: `string`):

Market awards. The Tendios organization ID of a buyer without a curated perimeter.

## `includeBuyerDependents` (type: `boolean`):

Market awards with a buyer organization ID. Also count its dependent bodies.

## `countryCode` (type: `string`):

Market awards. Two-letter tender-location country code, such as ES, limited to the countries your account can access.

## `includeModifications` (type: `boolean`):

Market awards. Also include contract modifications.

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

Stop after this many rows across every lookup. Pages of up to 100 are read as needed.

## `requestsPerMinute` (type: `integer`):

Pacing ceiling. Tendios allows 30 requests a minute per endpoint by default, shared by every key of the account.

## Actor input object example

```json
{
  "mode": "searchTenders",
  "onlyWithinDeadline": false,
  "minorContractsOnly": false,
  "withLotsOnly": false,
  "sort": "by-published-date",
  "sortDescending": true,
  "alertState": "any",
  "alertSort": "by-update-date",
  "includeBuyerDependents": true,
  "includeModifications": false,
  "maxResults": 100,
  "requestsPerMinute": 25
}
```

# Actor output Schema

## `records` (type: `string`):

One row per record the chosen mode read.

# 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("nabeelbaghoor/public-tenders-procurement-data-api").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("nabeelbaghoor/public-tenders-procurement-data-api").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 nabeelbaghoor/public-tenders-procurement-data-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nabeelbaghoor/public-tenders-procurement-data-api"
        }
    }
}
```

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/vat4TecVOWf6cxtnp/builds/dakgass5CWkOYdehC/openapi.json
