# StatFin Finland Statistics PxWeb Scraper (`parseforge/statfin-finland-pxweb-scraper`) Actor Browse the StatFin PxWeb tree from Statistics Finland by sub path. Each listing returns tableId, title, type, updated timestamp, and path, helping you map population, economy, and labor tables. Useful for open data discovery, Nordic research, and Finnish statistics integrations. - **URL**: https://apify.com/parseforge/statfin-finland-pxweb-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Education, Business, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $7.50 / 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## ๐Ÿ‡ซ๐Ÿ‡ฎ StatFin Finland Statistics PxWeb Scraper > ๐Ÿš€ **Export StatFin Finland data in seconds. Structured records ready for CSV, Excel, JSON, JSONL, XML, RSS, or HTML.** > ๐Ÿ•’ **Last updated:** 2026-06-05 ยท **๐Ÿ“Š 7 fields** per record ยท Public data ยท Real-time fetch The StatFin Finland Statistics PxWeb Scraper turns the public [StatFin Finland](https://statfin.stat.fi) endpoint into a clean, structured dataset. It calls the upstream API, parses the response, and flattens each record into one row, ready for downstream tooling. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | ๐Ÿ“Š Analysts and researchers | Build clean datasets from public StatFin Finland data. | | ๐Ÿข Finance and operations teams | Monitor key indicators on a schedule. | | ๐Ÿค– ML engineers | Construct training and evaluation sets. | | ๐Ÿ“ฐ Journalists | Verify figures and pull sources with one click. | | ๐Ÿ‘ฉโ€๐Ÿ’ป Developers | Mirror upstream data into your warehouse without writing client code. | ### ๐Ÿ“‹ What the StatFin Finland Statistics PxWeb Scraper does - Calls the public StatFin Finland endpoint with the filters you supply. - Parses the JSON or XML response and normalizes each record. - Casts numeric fields where possible so the data drops cleanly into Excel and BI tools. - Surfaces upstream errors and rate limits as a single record with the `error` field set. - Exports as CSV, Excel, JSON, JSONL, XML, RSS, or HTML. > ๐Ÿ’ก **Why it matters:** Public data is great, but raw API responses rarely map cleanly to a spreadsheet. This actor handles the plumbing so you can focus on analysis. ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon._ ### โš™๏ธ Input
FieldTypeRequiredDescription
maxItemsintegerNoFree users 10. Paid up to 1,000,000.
pathstringNoSub-path within StatFin PxWeb (e.g. vrm/vaerak). Empty = root listing.
**Example 1.** ```json { "maxItems": 10 } ```` **Example 2.** ```json { "maxItems": 50 } ``` > โš ๏ธ **Good to Know:** This actor talks to the public StatFin Finland endpoint. Upstream rate limits and availability apply. ### ๐Ÿ“Š Output Each record is a flat object. `error` is always last. | Field | Type | Description | |---|---|---| | `tableId` | string | Field returned by StatFin Finland. | | `title` | string | Field returned by StatFin Finland. | | `type` | string | Field returned by StatFin Finland. | | `updated` | string | Field returned by StatFin Finland. | | `path` | string | Field returned by StatFin Finland. | | `scrapedAt` | string | Field returned by StatFin Finland. | | `error` | string | Field returned by StatFin Finland. | ### โœจ Why choose this Actor | ๐Ÿ†“ | Works with the public StatFin Finland endpoint. No login required. | | ๐Ÿงน | Clean, normalized field names ready for BI tools. | | ๐Ÿ”ข | Numeric values are parsed as numbers, not strings. | | ๐Ÿ›Ÿ | Upstream errors surface as a single `error` record instead of crashing. | | ๐Ÿ’พ | Push to dataset, instant CSV, Excel, JSON, XML, RSS, or HTML export. | ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Setup time | Clean keys | Numeric casting | Error handling | |---|---|---|---|---| | Roll your own client | 30 min+ | โŒ | โŒ | โŒ | | **This Actor** | 5 sec, no install | โœ… | โœ… | โœ… | ### ๐Ÿš€ How to use 1. Click **Try for free**. 2. Adjust the filters (or leave defaults). 3. Click **Start**. Within seconds, your dataset is ready, download as CSV, Excel, JSON, or XML. ### ๐Ÿ’ผ Business use cases **๐Ÿ“Š Analytics dashboards.** Pipe StatFin Finland records into your BI stack for live monitoring. **๐Ÿ“ˆ Trend research.** Build historical series for strategy and forecasting. **๐Ÿ“ฐ Newsroom fact checking.** Verify a figure for a story without leaving the browser. **๐Ÿค– ML feature engineering.** Generate clean training inputs from public data. ### ๐Ÿ”Œ Automating StatFin Finland Statistics PxWeb Scraper - **Make and Zapier.** Trigger this actor on a schedule, route results to Sheets or Slack. - **Cron schedule.** Native Apify scheduler, every hour, day, or week. - **Webhooks.** POST to your endpoint the moment a run finishes. - **Pipe to BigQuery, Snowflake, Postgres.** Native Apify integrations move datasets straight into your warehouse. ### ๐ŸŒŸ Beyond business use cases **๐ŸŽ“ Education.** Use real public data in your statistics or economics class. **๐Ÿงช Personal research.** Build your own datasets for tinkering. **๐Ÿค Non-profit and open data.** Publish dashboards without writing client code. **๐Ÿงฐ Prototyping.** Spin up a real data feed in 5 seconds to test a new tool. ### ๐Ÿค– Ask an AI assistant about this scraper Drop this README into ChatGPT, Claude, or any AI assistant and ask it to map your specific workflow to the actor's inputs. ### โ“ Frequently Asked Questions **โ“ Is this real time?** Each run hits the upstream endpoint live. **โ“ Do I need an API key?** No. The actor uses public endpoints. **โ“ How are upstream errors handled?** A clean record with the `error` field set is pushed to the dataset. **โ“ Can I schedule runs?** Yes, use Apify's native scheduler or hook this up to Make or Zapier. **โ“ What export formats are supported?** CSV, Excel, JSON, JSONL, XML, RSS, or HTML. **โ“ How fresh is the data?** As fresh as StatFin Finland publishes it. **โ“ Can the schema change?** Core fields are stable. Upstream additions are passed through where possible. **โ“ Are values cast to numbers?** Yes where the upstream returns numeric strings. **โ“ Does it follow upstream pagination?** Where applicable yes, capped by `maxItems`. **โ“ Is this allowed?** Only public data is fetched. Comply with the upstream terms of use. ### ๐Ÿ”Œ Integrate with any app Apify ships native integrations with Make, Zapier, Slack, Discord, Google Drive, Google Sheets, Gmail, Airbyte, Keboola, Telegram, GitHub, and any REST API or webhook endpoint. Trigger runs from a calendar event, a form submission, a cron job, or pipe results straight into BigQuery, Snowflake, or a Postgres warehouse. ### ๐Ÿ”— Recommended Actors | Actor | What it does | |---|---| | [ParseForge Alpha Vantage Scraper](https://apify.com/parseforge/alpha-vantage-public-scraper) | Daily, intraday, FX, crypto, and indicators. | | [ParseForge OurAirports Scraper](https://apify.com/parseforge/ourairports-scraper) | Global airport database. | | [ParseForge NBA Stats Scraper](https://apify.com/parseforge/nba-stats-scraper) | Player and team stats. | | [ParseForge CurseForge Mods Scraper](https://apify.com/parseforge/curseforge-mods-scraper) | Public mod metadata. | > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for 900+ production-grade scrapers across business intelligence, real estate, e-commerce, sports, finance, and public records. *** **Disclaimer.** This actor scrapes only publicly available data. ParseForge is not affiliated with, endorsed by, or sponsored by any of the third-party services referenced. Users are responsible for complying with the target site's terms of service and applicable law. [Create a free account w/ $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp). # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `path` (type: `string`): Sub-path within StatFin PxWeb (e.g. vrm/vaerak). Empty = root listing. ## Actor input object example ```json { "maxItems": 10 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/statfin-finland-pxweb-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10 } # Run the Actor and wait for it to finish run = client.actor("parseforge/statfin-finland-pxweb-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": 10 }' | apify call parseforge/statfin-finland-pxweb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/statfin-finland-pxweb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "StatFin Finland Statistics PxWeb Scraper", "description": "Browse the StatFin PxWeb tree from Statistics Finland by sub path. Each listing returns tableId, title, type, updated timestamp, and path, helping you map population, economy, and labor tables. Useful for open data discovery, Nordic research, and Finnish statistics integrations.", "version": "0.1", "x-build-id": "n1tIVDpVhAq8wAYKR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~statfin-finland-pxweb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-statfin-finland-pxweb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/parseforge~statfin-finland-pxweb-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-statfin-finland-pxweb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/parseforge~statfin-finland-pxweb-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-statfin-finland-pxweb-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "path": { "title": "Subject path", "type": "string", "description": "Sub-path within StatFin PxWeb (e.g. vrm/vaerak). Empty = root listing." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```