Gov APItuik.gov.tr ↗
Access Turkey's official economic statistics from TÜİK: CPI, GDP, unemployment, industrial production, press releases, and time series data via 6 endpoints.
What is the Gov API?
This API exposes 6 endpoints covering Turkish Statistical Institute (TÜİK) data — including key economic indicators, historical time series, a full press release catalog, and the nested statistical themes tree. The get_popular_indicators endpoint returns the six headline figures displayed on the TÜİK homepage (CPI, unemployment, GDP growth, industrial production, consumer confidence, and population), each with its latest value, period, and bulletin ID.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/02835d6b-c0e3-4041-84c7-3e21add42bab/get_popular_indicators' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tuik-gov-tr-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.turkish_statistical_institute_tuik_api import (
Tuik, Indicator, ChartDataPoint, Theme, PressReleaseSummary,
PressRelease, IndicatorType
)
tuik = Tuik()
# List current headline economic indicators
for indicator in tuik.indicators.list():
print(indicator.baslik_en, indicator.deger, indicator.yil)
# Get CPI historical time series
for point in tuik.indicators.chart(indicator=IndicatorType.CPI):
print(point.x_deger, point.y_deger, point.baslik_en)
# Browse statistical themes
for theme in tuik.themes.list():
print(theme.id, theme.name)
# List press releases and drill into details
for release_summary in tuik.pressreleasesummaries.list():
detail = release_summary.details()
print(detail.title, detail.period, detail.date)
for table in detail.statistical_tables:
print(table.title, table.type)
# Convenience: get latest CPI release directly
cpi = tuik.pressreleases.get_cpi()
print(cpi.title, cpi.period)
for prev in cpi.previous_presses:
print(prev.title, prev.period, prev.url)
Get key economic indicators from the TÜİK homepage including CPI, Unemployment, GDP growth, Industrial Production, Consumer Confidence, and Population figures with their latest values and publication dates.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of indicator objects each containing baslikTR, baslikEN, yil, ay, deger, key, bultenID, gTarih, svgName"
},
"sample": {
"data": {
"items": [
{
"ay": 5,
"key": "__TUKETICI_FIYAT_ENDEKSI__",
"yil": 2026,
"deger": 32.61,
"gTarih": "05.06.2026",
"svgName": "Enflasyon_Fiyat_renkli",
"baslikEN": "Consumer Price Index (2025=100) Annual Change (%)",
"baslikTR": "Tüketici Fiyat Endeksi",
"bultenID": "58296"
}
]
},
"status": "success"
}
}About the Gov API
Economic Indicators and Time Series
get_popular_indicators returns an array of indicator objects with fields baslikTR, baslikEN, yil, ay, deger, key, and bultenID — covering the six metrics TÜİK highlights on its homepage. To retrieve historical data for any of those indicators, get_chart_data accepts an indicator parameter (accepted values: cpi, unemployment, gdp_growth, industrial_production, population, consumer_con) and returns an array of time-stamped data points with xDeger and yDeger fields suitable for charting trend lines.
Press Releases
get_press_releases_list returns every available TÜİK bulletin as an array of objects with id, title, url, categoryId, and categoryName. That id value is the input for get_press_release_detail, which returns the full bulletin content alongside statisticalTables, tables, metadatas, the release period, and a previous array linking to earlier releases in the same series — useful for building time-aware datasets from consecutive reports. get_cpi_data is a convenience shortcut that automatically resolves the most recent CPI release and returns the same response shape as get_press_release_detail without requiring a release_id.
Statistical Themes Tree
get_statistical_themes returns TÜİK's full data portal hierarchy as a nested object. Each node carries id, name, icon, url, and a children array, covering all statistical categories and subcategories — from agriculture and demography to trade and national accounts. This endpoint is the entry point for navigating the breadth of TÜİK's published datasets, identifying which categories have associated press releases or downloadable tables.
The Gov API is a managed, monitored endpoint for tuik.gov.tr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tuik.gov.tr changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official tuik.gov.tr API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track Turkey's monthly CPI trend by polling
get_chart_datawithindicator=cpiand storing thedegertime series. - Build a Turkey macroeconomic dashboard by combining
get_popular_indicatorsfields for GDP growth, unemployment, and consumer confidence. - Enumerate all TÜİK press releases by category using
get_press_releases_listand filter bycategoryNamefor topic-specific monitoring. - Extract embedded statistical tables from inflation bulletins using
get_press_release_detailwith a CPI-seriesrelease_id. - Navigate TÜİK's full statistical catalog programmatically by traversing the
childrenarrays returned byget_statistical_themes. - Detect new TÜİK publications by comparing the
previousarray across successive calls toget_press_release_detail. - Retrieve the latest CPI report content and metadata without managing bulletin IDs by calling
get_cpi_datadirectly.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does TÜİK have an official developer API?+
What does `get_press_release_detail` return beyond the main bulletin text?+
statisticalTables (structured table data embedded in the release), tables (additional tabular content), metadatas (descriptive metadata for the release), the period the release covers, and a previous array of earlier releases in the same series. The lastPress field identifies the most recent release in that bulletin series.Which economic indicators can be retrieved as historical time series?+
get_chart_data supports six indicator keys: cpi, unemployment, gdp_growth, industrial_production, population, and consumer_con. Each returns an array of data points with yil (year), ay (month/period), and deger (value) fields, along with xDeger and yDeger for chart coordinates.Does the API cover regional or provincial breakdowns of TÜİK statistics?+
Can I retrieve downloadable dataset files (Excel, CSV) through this API?+
get_statistical_themes returns url fields that point to downloadable tables on the TÜİK portal, but the API does not fetch or parse those file contents. You can fork the API on Parse and revise it to add file-fetching endpoints for those URLs.