# Greece Public Procurement Scraper (KIMDIS) (`publicmoney/kimdis-greece-scraper`) Actor

Extract Greek public procurement from KIMDIS open data: tender notices, awards, contracts and payment orders with buyer, CPV, values, contractors and documents.

- **URL**: https://apify.com/publicmoney/kimdis-greece-scraper.md
- **Developed by:** [Public Money](https://apify.com/publicmoney) (Apify)
- **Categories:** Business
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.00 / 1,000 tenders

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

This Actor reads **KIMDIS** (ΚΗΜΔΗΣ), Greece's central electronic registry of public contracts, through its open data service: tender notices, awards, signed contracts and payment orders submitted in a date range, with buyer, procedure, contract type, CPV codes, values with and without VAT, contractors, funding and a link to each signed PDF.

### What it does

- **Four record types** (`mode`): `notices` (calls, invitations, tender notices), `awards`, `contracts`, `payments` (payment orders).
- **By submission day**: on 15 September 2026, 933 notices, 1,202 awards, 1,133 contracts and 2,736 payment orders; September 2026 had 21,240 notices.
- Buyer and its VAT number, procedure (e.g. direct award, open), contract type, legal context, NUTS region, contract duration, line items with quantity, unit, cost, VAT rate and CPV codes.
- Contractors with country and, for companies, VAT number; bids submitted; links to the related notice, award, contract and payment.
- **Filters** (applied by KIMDIS): title keyword, CPV code, contract type, contractor name, value range.

### Use cases

| You need to | How this Actor does it |
| --- | --- |
| Find new Greek tenders | `mode` `notices`, read `finalSubmissionDate` |
| See who wins public contracts | `mode` `contracts`, read `contractors` and `totalCostWithoutVAT` |
| Track one supplier | `contractorName`, e.g. SIEMENS |
| Follow public spending | `mode` `payments` |
| Watch a market | `cpvCode`, e.g. 90470000-2, or `keyword` |

### Input

| Field | Type | Default | What it controls |
| --- | --- | --- | --- |
| `mode` | string | `notices` | `notices`, `awards`, `contracts`, `payments` |
| `dateFrom` | string | two days ago | First submission day |
| `dateTo` | string | today | Last submission day |
| `keyword` | string | empty | Title |
| `cpvCode` | string | empty | CPV code(s), e.g. 90470000-2 |
| `contractType` | string | any | `SERVICES`, `SUPPLIES`, `WORKS`, `STUDIES`, `TECHNICAL_SERVICES` |
| `contractorName` | string | empty | Contractor (awards, contracts) |
| `minValue` / `maxValue` | number | empty | Total cost range (EUR) |
| `maxItems` | integer | `500` | Caps how many records are returned, and so the cost |

```json
{
    "mode": "contracts",
    "dateFrom": "2026-09-15",
    "dateTo": "2026-09-15"
}
```

### Output

```json
{
    "mode": "contracts",
    "referenceNumber": "26SYMV019780549",
    "title": "Προμήθεια σε Χαρτοκυτία και σακούλες μολυσματικών αποβλήτων για την ετήσια κάλυψη όλων των δομών",
    "buyer": "ΔΥΠΕ   Α'  ΑΤΤΙΚΗΣ",
    "procedureType": "Ανοιχτή διαδικασία",
    "contractType": "Προμήθειες",
    "contractors": "Γεράσιμος Π. Πετρουλάκης Εμπόριο Ειδών Καθαριότητας και Συσκευασίας",
    "cpvCodes": [
        "44617100-9 Χαρτοκιβώτια"
    ],
    "submissionDate": "2026-09-15T09:28:58.438",
    "contractSignedDate": "2026-09-15",
    "totalCostWithoutVAT": 27462.2,
    "totalCostWithVAT": 34053.13,
    "nutsCode": "EL303",
    "documentUrl": "https://cerpp.eprocurement.gov.gr/khmdhs-opendata/contract/attachment/26SYMV019780549"
}
```

### Coverage and limits

- Texts are in Greek, as published. Code lists are given by their label; NUTS, country and currency by their code.
- The signing official's name and the author e-mail are not included, and a contractor's VAT number is included only for companies.

### Pricing

Pay per event: one `tender-scraper` event per record written to the dataset. The optional schema.org block is charged once per run.

# Actor input Schema

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

Which KIMDIS register to read.

## `dateFrom` (type: `string`):

First day a record was submitted to KIMDIS, YYYY-MM-DD. Default: two days before today. 15 September 2026 had 933 notices and 1,133 contracts.

## `dateTo` (type: `string`):

Last submission day, inclusive, YYYY-MM-DD. Default: today.

## `keyword` (type: `string`):

Matched by KIMDIS in the title, e.g. 'ΣΥΝΤΗΡΗΣΗ' (maintenance). Up to 100 characters.

## `cpvCode` (type: `string`):

CPV code with check digit, e.g. '90470000-2'. Several may be comma-separated.

## `contractType` (type: `string`):

Leave empty for all.

## `contractorName` (type: `string`):

Contractor name, for awards and contracts, e.g. 'SIEMENS'. Up to 30 characters.

## `minValue` (type: `integer`):

Lowest total cost in EUR.

## `maxValue` (type: `integer`):

Highest total cost in EUR.

## `maxItems` (type: `integer`):

Caps how many records are written to the dataset, and so caps the cost. Set to 0 for everything matched.

## `schemaOrg` (type: `boolean`):

Appends a `schemaOrg` object to every record, mapping it to schema.org (Demand). Charged once per run, not per record.

## Actor input object example

```json
{
  "mode": "notices",
  "maxItems": 500,
  "schemaOrg": false
}
```

# Actor output Schema

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

Notices, awards, contracts or payment orders matched by the run, one item per record, in the default dataset.

# 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 = {
    "maxItems": 500
};

// Run the Actor and wait for it to finish
const run = await client.actor("publicmoney/kimdis-greece-scraper").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 = { "maxItems": 500 }

# Run the Actor and wait for it to finish
run = client.actor("publicmoney/kimdis-greece-scraper").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 '{
  "maxItems": 500
}' |
apify call publicmoney/kimdis-greece-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,publicmoney/kimdis-greece-scraper"
        }
    }
}
```

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/4CrYdeAqb1R2EdWRQ/builds/w5W9XP2CxF8lbgyMw/openapi.json