# TurkStat Turkey Statistics Scraper (`parseforge/turkstat-turkey-statistics-scraper`) Actor

Query TurkStat (TÜİK) categories and pull Turkish national statistics with indicator, value, period, region, category, unit, source, and release\_date. Useful for inflation analysis, demographic research, and macroeconomic dashboards covering the Turkish lira, employment, and trade.

- **URL**: https://apify.com/parseforge/turkstat-turkey-statistics-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation, Integrations
- **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)

## 📊 TurkStat Turkey Statistics Scraper

> 🚀 **Export Turkey's official TurkStat (TÜİK) statistics in seconds. Indicators, values, periods, regions, and release dates straight from the national statistics office.**

> 🕒 **Last updated:** 2026-05-29 · **📊 10 fields** per record · Hundreds of indicator categories · Bilingual Turkish and English

The TurkStat Turkey Statistics Scraper turns the [data.tuik.gov.tr](https://data.tuik.gov.tr) public category endpoint into a clean dataset. It calls the GetKategori service and flattens each indicator into one row with value, period, region, unit, and release date.

Coverage spans every public TurkStat indicator category accessible via the public data portal, in both Turkish and English.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| 📊 Macro analysts | Pull Turkey GDP, inflation, unemployment trends |
| 🏛️ Researchers | Build cross-country comparison datasets |
| 📰 Journalists | Source authoritative TÜİK numbers for stories |
| 🤖 Data engineers | Mirror Turkish statistics into a warehouse |
| 🎓 Academics | Cite primary source data in papers |
| 💼 Investors | Track macro indicators for Turkey allocation |

### 📋 What the TurkStat Turkey Statistics Scraper does

- Calls the public TurkStat GetKategori endpoint for the requested category.
- Flattens each indicator row into a normalized record.
- Supports both Turkish and English responses.
- Surfaces upstream errors as a clean diagnostic row.

> 💡 **Why it matters:** TurkStat's bulletin PDFs and Excel files are awkward to ingest at scale. This actor exposes the underlying JSON used by the portal so analysts can pull numbers programmatically.

### 🎬 Full Demo

_🚧 Coming soon._

### ⚙️ Input

<table>
<tr><th>Field</th><th>Type</th><th>Required</th><th>Description</th></tr>
<tr><td><code>categoryId</code></td><td>integer</td><td>No</td><td>TurkStat category ID. Omit for the top-level tree.</td></tr>
<tr><td><code>language</code></td><td>enum</td><td>No</td><td>tr or en.</td></tr>
<tr><td><code>maxItems</code></td><td>integer</td><td>No</td><td>Free 10, paid up to 1,000,000.</td></tr>
</table>

**Example 1 - Top-level categories in English:**
```json
{ "language": "en", "maxItems": 50 }
````

**Example 2 - Specific category:**

```json
{ "categoryId": 23, "language": "tr", "maxItems": 100 }
```

> ⚠️ **Good to Know:** TurkStat's category tree changes when the portal is reorganized. If a category ID returns nothing, fetch the tree by leaving `categoryId` empty.

### 📊 Output

| Field | Type | Description |
|---|---|---|
| 📊 `indicator` | string | Indicator name. |
| 🔢 `value` | string | Reported value. |
| 📅 `period` | string | Time period. |
| 🗺️ `region` | string | Geographic area. |
| 🗂️ `category` | string | Category ID. |
| 📐 `unit` | string | Unit of measure. |
| 🏛️ `source` | string | TurkStat (TÜİK). |
| 📆 `release_date` | string | Indicator release date. |
| 🕒 `scrapedAt` | string | When this row was fetched. |
| ❌ `error` | string | Set if upstream response was an error. |

**Sample record:**

```json
{
  "indicator": "Consumer Price Index",
  "value": "1832.42",
  "period": "2025-04",
  "region": "Turkey",
  "category": "23",
  "unit": "2003=100",
  "source": "TurkStat (TÜİK)",
  "release_date": "2025-05-03",
  "scrapedAt": "2026-05-29T13:00:00.000Z",
  "error": null
}
```

### ✨ Why choose this Actor

| 🆓 | Works with no API key. |
| 🌍 | Bilingual Turkish and English output. |
| 🧹 | Normalized field names across categories. |
| 💾 | Push to dataset and export CSV, Excel, JSON, or XML. |

### 📈 How it compares to alternatives

| Approach | Setup time | Clean rows | Maintained |
|---|---|---|---|
| Manual download from TÜİK | 15 min per indicator | ❌ | manual |
| Eurostat mirror | partial coverage | partial | varies |
| **This Actor** | 5 sec, no install | ✅ | live |

### 🚀 How to use

1. Click **Try for free**.
2. Pick a `categoryId` and `language`.
3. Click **Start**.

### 💼 Business use cases

**📊 Macro dashboards.** Pipe TurkStat indicators into your country risk dashboard.

**📰 Newsroom verification.** Confirm inflation, GDP, and unemployment numbers in seconds.

**🤖 Quant pipelines.** Ingest Turkish macro series alongside global indicators.

**💼 Investor reports.** Build sector-specific charts using primary source data.

### 🔌 Automating TurkStat Turkey Statistics Scraper

- **Make / Zapier**: trigger this actor and push to Airtable, Google Sheets, or Slack.
- **Cron schedule**: monthly refreshes aligned with TurkStat release calendars.
- **Webhooks**: POST to your endpoint after each run.
- **Pipe to BigQuery / Snowflake / Postgres**: native integrations.

### 🌟 Beyond business use cases

**🎓 Education.** Teach intro macro with real Turkish indicators.

**🧪 Personal research.** Track Turkish inflation against your savings rate.

**🤝 Non-profit.** Build civic dashboards using authoritative figures.

**🧰 Prototyping.** Mock up a data product without paying for Bloomberg.

### 🤖 Ask an AI assistant about this scraper

Paste this README into ChatGPT or Claude.

### ❓ Frequently Asked Questions

**❓ Do I need an API key?** No.

**❓ Which categories are covered?** Every category in the TurkStat public portal.

**❓ Is the data official?** Yes, TÜİK is Turkey's national statistical authority.

**❓ Can I get English?** Yes, set `language` to `en`.

**❓ How fresh is the data?** Live with TurkStat releases.

**❓ Can I schedule runs?** Yes via the Apify scheduler.

**❓ Is this scraping or API?** Public JSON endpoints used by data.tuik.gov.tr.

**❓ What format can I download?** CSV, Excel, JSON, JSONL, XML, RSS, or HTML.

**❓ What if the category returns nothing?** A diagnostic record with `error` is pushed.

**❓ Will the schema change?** Stable.

### 🔌 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.

### 🔗 Recommended Actors

| Actor | What it does |
|---|---|
| [ParseForge ONPE Peru Elections Scraper](https://apify.com/parseforge/onpe-peru-elections-scraper) | Peru election results. |
| [ParseForge CNES Brazil Health Scraper](https://apify.com/parseforge/cnes-brazil-health-establishments-scraper) | Brazil health establishments. |
| [ParseForge collection](https://apify.com/parseforge) | 900+ production scrapers. |

> 💡 **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

## `categoryId` (type: `integer`):

TurkStat category ID. Leave empty to fetch the top-level category tree.

## `language` (type: `string`):

Language code for the response.

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

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

## Actor input object example

```json
{
  "language": "en",
  "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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "language": "en",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/turkstat-turkey-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 = {
    "language": "en",
    "maxItems": 10,
}

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

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/turkstat-turkey-statistics-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "TurkStat Turkey Statistics Scraper",
        "description": "Query TurkStat (TÜİK) categories and pull Turkish national statistics with indicator, value, period, region, category, unit, source, and release_date. Useful for inflation analysis, demographic research, and macroeconomic dashboards covering the Turkish lira, employment, and trade.",
        "version": "0.1",
        "x-build-id": "iJ5tvLcfFfaLdbhev"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~turkstat-turkey-statistics-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-turkstat-turkey-statistics-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~turkstat-turkey-statistics-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-turkstat-turkey-statistics-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~turkstat-turkey-statistics-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-turkstat-turkey-statistics-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": {
                    "categoryId": {
                        "title": "Category ID",
                        "type": "integer",
                        "description": "TurkStat category ID. Leave empty to fetch the top-level category tree."
                    },
                    "language": {
                        "title": "Language",
                        "enum": [
                            "tr",
                            "en"
                        ],
                        "type": "string",
                        "description": "Language code for the response.",
                        "default": "tr"
                    },
                    "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"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```