# Slovakia DATAcube Statistics Scraper (`parseforge/slovakia-datacube-statistics-scraper`) Actor

Scrape official Slovak statistics from DATAcube (Statistical Office of the Slovak Republic) by table ID. Filter dimensions with a JSON query, choose English or Slovak labels, export to CSV, JSON, Excel or XML.

- **URL**: https://apify.com/parseforge/slovakia-datacube-statistics-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.52 / 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.
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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Slovakia DATAcube Statistics Scraper

**Scrape official Slovak statistics from DATAcube by table ID, with full control over language and query filters.** Every row is a flat record ready for CSV, JSON, Excel, or XML. No API key, no registration, no rate-limit headaches.

Slovakia's official statistics portal, DATAcube, publishes thousands of datasets from the Statistical Office of the Slovak Republic, but its web interface is built for browsing, not bulk export. This Actor reads the public PxWeb API directly, so you can pull any table by its ID, filter with a JSON query, and get every matching row in one fixed schema. It works for population, economy, labour, education, and hundreds of other official indicators.

| Who uses it | What they scrape Slovakia DATAcube for |
|---|---|
| Data journalists | Pull official population or economy figures for a story without manual downloads |
| Market researchers | Get regional demographic or labour statistics for Slovakia in bulk |
| Public policy analysts | Track official indicators over time for reports and dashboards |
| Academic researchers | Collect consistent, citable datasets from the national statistics office |

### What it does

This Actor collects rows from a Slovakia DATAcube statistics table by table ID and returns each row as a flat record.

- 🔢 **Table ID input:** pass any DATAcube table identifier, like om2024rs, and get every member of every dimension for the latest period by default
- 🌐 **Language selection:** return labels and metadata in English or Slovak
- 🎯 **Query JSON filtering:** pick member codes per dimension, as a plain object or a PxWeb-style selection array, to select specific regions, periods, or variables
- 📦 **Flat row output:** every statistic becomes one row, ready for CSV, JSON, Excel, or XML export

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Slovakia DATAcube data

**📊 Build a regional dashboard.**

A data analyst pulls monthly unemployment statistics for all Slovak regions and feeds the flat rows into a BI tool for a live dashboard.

**📰 Fact-check a news story.**

A journalist retrieves the latest population figures from the official table and compares them with claims made in a press release.

**🎓 Collect data for a thesis.**

A graduate student downloads a full education statistics table in Slovak and English to analyse enrolment trends over a decade.

**🏛️ Monitor policy indicators.**

A public sector analyst schedules weekly runs of a key economic table to track changes and alert stakeholders.

### Why choose this scraper

| | What you get |
|---|---|
| **Official source** | Data comes directly from the Statistical Office of the Slovak Republic, so it is citable and authoritative |
| **No API key** | The public PxWeb endpoint needs no registration or authentication |
| **Flexible queries** | Filter any dimension by member code, with a plain JSON object or a PxWeb-style selection array |
| **Bulk export** | Get up to 1,000,000 rows per run for paid users, or a 10-row preview for free |

### How it compares

No other Store actor targets Slovakia DATAcube the same way, so the honest comparison is with the alternatives teams actually weigh.

| | Slovakia DATAcube Statistics Scraper | Build it in-house | By hand |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When Slovakia DATAcube changes | Maintained for you | You fix it | You re-learn the page |
| API quirks (cube size limits, member codes, dimension paths) | Handled for you | Your problem | Manual |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |

### Configure the run

Drive the Actor with a DATAcube table ID, optionally add a JSON query to select specific dimensions, and set the response language. The maximum rows limit controls how many statistics rows are returned. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "tableId": "om2024rs",
 "maxItems": 10
}
```

A larger pull:

```json
{
 "tableId": "om2024rs",
 "maxItems": 200
}
```

A filtered pull. Dimension names accept the full id (om2024rs\_rok) or its suffix (rok), and values are member codes, not labels. Dimensions you leave out return every member, except the time dimension, which defaults to the latest period:

```json
{
 "tableId": "om2024rs",
 "maxItems": 200,
 "query": "{\"rok\":[\"2024\",\"2025\"],\"vek\":[\"08vekr000\",\"08vekr001\",\"08vekr002\"]}"
}
```

The same selection in PxWeb style: `[{"code":"om2024rs_rok","selection":{"filter":"item","values":["2024","2025"]}}]`. Member codes for any dimension are listed by the official API, for example https://data.statistics.sk/api/v2/dataset/om2024rs/x/x/x/all?lang=en for the age dimension of om2024rs. A value that matches no member code stops the run with an error row naming the dimension and its first codes.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Slovakia DATAcube Statistics Scraper](https://apify.com/parseforge/slovakia-datacube-statistics-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Slovakia DATAcube through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/slovakia-datacube-statistics-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that the table ID is correct and that your Query JSON does not filter out all values. Try leaving the query empty to see if the table returns any rows at all.

**Why does the run fail with an error?**

The upstream DATAcube API may be temporarily unavailable or the table ID may be invalid. Verify the ID on the official website and retry after a few minutes.

**Why do I only get 10 rows?**

Free users are limited to a 10-row preview. Upgrade to a paid plan and set maxItems to a higher value to get more rows.

**Why are the labels in English when I wanted Slovak?**

Set the lang input to sk. If the table itself has no Slovak labels, the API will return whatever is available.

**Why is my Query JSON not working?**

The query must be valid JSON: either an object mapping dimension names to arrays of member codes, or a PxWeb-style array of selection objects. Invalid JSON is ignored with a warning. Values must be member codes (08vekr000), not labels (0). A code that matches nothing stops the run with an error row that lists the first valid codes of that dimension.

### FAQ

| Question | Answer |
|---|---|
| Where do I find the table ID? | Open the dataset on the DATAcube website. The table ID is the short code in the URL, for example om2024rs. You can also browse the official API catalogue. |
| Can I get data in Slovak? | Yes. Set the language input to sk and all labels and metadata will be returned in Slovak. |
| How do I filter the results? | Use the Query JSON input. It accepts a plain object of dimension names to member codes, or a PxWeb-style array of selection objects. Leave it empty to get every member for the latest period. |
| What is the maximum number of rows? | Free users get a 10-row preview. Paid users can set maxItems up to 1,000,000 rows per run. |
| Do I need an API key? | No. The Actor uses the public PxWeb endpoint of the Statistical Office of the Slovak Republic, which requires no authentication. |
| What format is the output? | Each statistics row is returned as a flat record. You can export the dataset to CSV, JSON, Excel, or XML from Apify. |
| Can I scrape multiple tables at once? | This Actor handles one table per run. To scrape multiple tables, run it once per table ID or use Apify's scheduler to run several configurations. |
| Is this legal? | Yes. DATAcube is a public service of the Slovak government, and the data is published for public use. Always check the terms of use for any specific dataset. |
| What if the table ID is wrong? | The Actor will return an error from the upstream API. Double-check the ID on the DATAcube website and try again. |
| Can I get historical data? | Yes, if the table contains historical values. Use the Query JSON to select specific time periods. |

### Related actors

- [Statistics Canada Data Tables Scraper](https://apify.com/parseforge/statcan-canada-scraper?fpr=vmoqkp)
- [CBS Netherlands Statistics Scraper](https://apify.com/parseforge/cbs-netherlands-statistics-scraper?fpr=vmoqkp)
- [OECD SDMX Statistics Scraper](https://apify.com/parseforge/oecd-sdmx-scraper?fpr=vmoqkp)
- [UN Comtrade Scraper](https://apify.com/parseforge/un-comtrade-scraper?fpr=vmoqkp)
- [EU Open Data Portal Scraper](https://apify.com/parseforge/euopendata-datasets-scraper?fpr=vmoqkp)

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Statistical Office of the Slovak Republic. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `tableId` (type: `string`):

Slovakia DATAcube table identifier (for example om2024rs). Browse https://data.statistics.sk/api/v2/collection?lang=en for the full list of table IDs.

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

Free users: Limited to 10 statistics rows (preview). Paid users: Optional, max 1,000,000.

## `lang` (type: `string`):

Language of the labels and the table title.

## `query` (type: `string`):

Optional. Selects dimension members. Either a JSON object such as {"rok":\["2024","2025"],"vek":\["0","1","2"]} or a PxWeb-style array such as \[{"code":"om2024rs\_rok","selection":{"filter":"item","values":\["2024","2025"]}}]. Dimension names accept the full id (om2024rs\_rok) or its suffix (rok). Dimensions you leave out return every member, except the time dimension, which defaults to the latest period.

## Actor input object example

```json
{
  "tableId": "om2024rs",
  "maxItems": 10,
  "lang": "en"
}
```

# Actor output Schema

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

No description

# 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 = {
    "tableId": "om2024rs",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/slovakia-datacube-statistics-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 = {
    "tableId": "om2024rs",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/slovakia-datacube-statistics-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 '{
  "tableId": "om2024rs",
  "maxItems": 10
}' |
apify call parseforge/slovakia-datacube-statistics-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/slovakia-datacube-statistics-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/edFhl6LTyklfUgtlx/builds/dmnslD09eTZXgMEPY/openapi.json