tuik.org.tr 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.
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'
Retrieve the popular statistical indicators displayed on the TÜİK data portal homepage, including CPI, unemployment rate, GDP growth, industrial production, consumer confidence, and population figures with their associated chart data.
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/4",
"value": 32.37,
"graphics": [
{
"type": "line",
"title": "Tüketici Fiyat Endeksi Yıllık (%)",
"labels": [
"2024/08",
"2024/09"
],
"series": [
{
"data": [
51.97,
49.38
],
"title": "Tüketici Fiyat Endeksi - Yıllık"
}
]
}
],
"pressUrl": "/tr/press/58288"
}
],
"isError": false,
"message": "ok"
},
"status": "success"
}
}About the tuik.org.tr 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.
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.
- 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 | 250 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.