Org APItuik.org.tr ↗
Access Turkey's official CPI, GDP, unemployment, and foreign trade statistics from TÜİK's data portal. Retrieve press releases, indicators, and historical bulletin series.
What is the Org API?
This API provides structured access to Turkey's official statistics from TÜİK's data portal across 10 endpoints. It returns real-time economic indicators with chart data, full press release content with statistical tables, methodology metadata, and historical bulletin series. The get_homepage_popular_indicators endpoint alone exposes CPI, GDP growth, unemployment rate, industrial production, consumer confidence, and population figures in a single call.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/0a41bda1-28ab-4d53-8dcc-f040ab4852b2/get_homepage_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-org-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.T__K__TurkStat__Data_Portal_API import Turkstat, PressReleaseSummary, SearchResult, BulletinHistoryEntry, PressReleaseNotFound
turkstat = Turkstat()
# List popular indicators on the homepage (CPI, GDP, unemployment, etc.)
for indicator in turkstat.indicators.list(limit=3):
print(indicator.date, indicator.value)
# Browse all press release types available on the portal
for release in turkstat.press_release_summaries.list(limit=5):
print(release.title, release.category_name)
# Search the data portal for inflation-related statistics
for result in turkstat.search_results.search(query="enflasyon", limit=3):
print(result.title, result.date)
# Fetch historical CPI bulletins by keyword
for entry in turkstat.bulletin_history_entries.list(title_keyword="TÜFE", limit=3):
print(entry.title, entry.date)
# Fetch the latest CPI bulletin directly
cpi = turkstat.press_releases.latest_cpi()
print(cpi.title, cpi.period)
# Handle a missing press release gracefully
try:
detail = turkstat.press_releases.get(id="99999999")
print(detail.title)
except PressReleaseNotFound as exc:
print(f"Press release not found: {exc}")
print("exercised: indicators.list / press_release_summaries.list / search_results.search / bulletin_history_entries.list / press_releases.latest_cpi / press_releases.get")
Retrieve the popular statistical indicators displayed on the TÜİK data portal homepage. Returns six key indicators (CPI, unemployment rate, GDP growth, industrial production, consumer confidence, population) with their latest values, reference periods, and associated chart data (time-series labels and data points).
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of indicator objects, each containing id, pressUrl, date, value, and graphics (chart data with labels and series)",
"isError": "boolean indicating API error status",
"message": "string status message from API"
},
"sample": {
"data": {
"data": [
{
"id": 1,
"date": "2026/5",
"value": 32.61,
"graphics": [
{
"type": "line",
"title": "Tüketici Fiyat Endeksi Yıllık (%)",
"labels": [
"2024/09",
"2024/10"
],
"series": [
{
"data": [
49.38,
48.58
],
"fill": true,
"title": "Tüketici Fiyat Endeksi - Yıllık",
"borderColor": "#276993",
"backgroundColor": "#276993"
}
],
"xAxesTitle": "Yıl/Ay",
"yAxesTitle": "(%)"
}
],
"pressUrl": "/tr/press/58296"
}
],
"isError": false,
"message": "ok"
},
"status": "success"
}
}About the Org API
Economic Indicators and Press Releases
The get_homepage_popular_indicators endpoint returns an array of indicator objects, each with an id, pressUrl, date, value, and a graphics object containing chart labels and series data — suitable for building dashboards or time-series visualizations without additional processing. The get_press_releases_list endpoint returns every press release type available on the portal, including id, title, url, categoryId, and categoryName, giving you a full index to navigate by category.
To fetch full bulletin content, pass a numeric id to get_press_release_detail. The response includes the HTML content of the release, statisticalTables, downloadable reports, structured metadatas, and a previousPres array linking back through older releases in the same series. For methodology and definitions, get_press_release_metadata returns an array of documentation sections, each with a title and nested data array containing HTML detail items covering classifications, data definitions, and calculation rules.
Convenience Endpoints for Key Indicators
Three dedicated endpoints — get_latest_cpi_bulletin, get_latest_gdp_bulletin, and get_latest_foreign_trade_bulletin — each return the full press release detail object for their respective topics without requiring you to look up an ID first. This is useful for scheduled jobs that pull the latest figures for inflation (TÜFE), national accounts (GSYH), or import/export data as soon as a new release is published.
Search and Historical Series
The search_data_portal endpoint accepts a query string (Turkish or English, e.g. 'enflasyon', 'nüfus', 'işsizlik') and returns paginated results with date, type, title, a content snippet, and url, along with a filter object containing typeList, categoryList, subCategoryList, levelList, and yearList facets. To retrieve a release history for a topic, get_bulletin_series_history accepts a title_keyword and returns a sorted list of matching bulletin objects — each with id, title, date, and a content snippet — covering the full archive of that series. The get_statistical_themes_list endpoint returns the complete hierarchical theme tree, with each node carrying id, name, icon, url, and nested children arrays down to individual press releases and databases.
The Org API is a managed, monitored endpoint for tuik.org.tr — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tuik.org.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.org.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?+
- Tracking Turkey's monthly CPI trend by pulling
get_latest_cpi_bulletinon a schedule and storing thestatisticalTablesdata - Building a Turkish macroeconomic dashboard using the
valueandgraphicsfields fromget_homepage_popular_indicators - Archiving historical GDP press releases by iterating
get_bulletin_series_historywith the keyword'Gayrisafi'and fetching eachidviaget_press_release_detail - Generating methodology documentation for a report by calling
get_press_release_metadatato extract classification and calculation rules - Searching TÜİK for all releases related to population or migration using
search_data_portalwith Turkish-language keywords and filtering bycategoryList - Mapping the full TÜİK data catalog by traversing the
childrentree returned byget_statistical_themes_list - Monitoring Turkey's foreign trade balance by fetching
get_latest_foreign_trade_bulletinafter each monthly release cycle
| 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 headline figure?+
content body, statisticalTables (structured table data embedded in the release), downloadable reports, metadatas sections covering definitions and methodology, and a previousPres array that links to earlier releases in the same series — useful for building a time series without a separate history query.Does `search_data_portal` support pagination or filtering by year?+
total count and a filter object that includes yearList, typeList, categoryList, subCategoryList, and levelList facets alongside the results. The current endpoint takes only a query string; server-side filtering by year or category is not exposed as a separate parameter. You can fork this API on Parse and revise it to add pagination offset or filter parameters if your use case requires them.Are regional or province-level breakdowns available through these endpoints?+
content and statisticalTables fields may contain regional breakdowns embedded in the release itself, but there is no dedicated endpoint for querying by province or NUTS region. You can fork this API on Parse and revise it to add a region-specific endpoint if TÜİK publishes that data in a separate addressable resource.How far back does `get_bulletin_series_history` go?+
title_keyword and returns results sorted newest-first. Coverage depends on how far back TÜİK's own portal indexes its releases; there is no explicit date cutoff imposed by the endpoint. Results include id, title, date, and a content snippet for each matched bulletin.