# Tuik (tuik.org.tr) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access Turkey's official economic and social statistics including real-time CPI, GDP, and unemployment indicators, along with detailed press releases and historical data series. Search and retrieve specific statistical themes, economic bulletins, and key economic indicators directly from TÜİK's official data portal.

**Category:** Government & Public Data | **Website:** [tuik.org.tr/](https://tuik.org.tr/) | **Docs:** [parse.bot/marketplace/956cbbfb-f3d5-43b6-b6a1-da4809e2d89d/tuik-org-tr-api](https://parse.bot/marketplace/956cbbfb-f3d5-43b6-b6a1-da4809e2d89d/tuik-org-tr-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bulletin_series_history

Fetch the release history for a specific statistical topic by searching bulletin titles with a keyword. Returns a list of matching press releases sorted by date (newest first) with their IDs, titles, dates, and content snippets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `title_keyword` | string | Yes | Keyword to search in bulletin titles (e.g. 'TÜFE', 'Dış Ticaret', 'Gayrisafi', 'işsizlik') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_bulletin_series_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title_keyword":"<string>"}'
```

### get_homepage_popular_indicators

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).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_homepage_popular_indicators \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_latest_cpi_bulletin

Fetch the latest Consumer Price Index (Tüketici Fiyat Endeksi / TÜFE) bulletin details by searching for the most recent CPI press release and returning its full content including HTML body, statistical tables, metadata, and previous release links.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_latest_cpi_bulletin \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_latest_foreign_trade_bulletin

Fetch the latest Foreign Trade Statistics (Dış Ticaret İstatistikleri) bulletin details by searching for the most recent foreign trade press release and returning its full content.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_latest_foreign_trade_bulletin \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_latest_gdp_bulletin

Fetch the latest GDP/National Accounts (Dönemsel Gayrisafi Yurt İçi Hasıla / GSYH) bulletin details by searching for the most recent GDP press release and returning its full content.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_latest_gdp_bulletin \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_press_release_detail

Fetch the full content of a specific press release by its numeric ID, including HTML content, statistical tables with download links, downloadable reports, metadata sections, and links to previous releases in the same series.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Numeric ID of the press release (e.g. '58296' for CPI May 2026). Obtain IDs from get_press_releases_list, search_data_portal, or get_bulletin_series_history. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_press_release_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_press_release_metadata

Fetch methodology and metadata documentation for a specific press release/bulletin, including contact info, statistical presentation, data definitions, classifications, and calculation rules.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Numeric ID of the press release (e.g. '58296'). Obtain IDs from get_press_releases_list or search_data_portal. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_press_release_metadata \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"<string>"}'
```

### get_press_releases_list

Fetch the full alphabetical list of all statistical press release types available on the TÜİK portal. Each entry includes a numeric ID, title, URL path, category ID, and category name. Use the returned IDs with get_press_release_detail or get_press_release_metadata.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_press_releases_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_statistical_themes_list

Fetch the full hierarchical tree of statistical themes, categories, sub-categories, press releases, tables, and databases available on the TÜİK data portal.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/get_statistical_themes_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_data_portal

Search for items in the TÜİK data portal by keyword. Returns paginated results including press releases, tables, charts, metadata, reports, and databases matching the query, along with filter facets for type, category, sub-category, region, and year.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'enflasyon', 'nüfus', 'GDP', 'işsizlik') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-tuik-org-tr-api-956cbbfb/search_data_portal \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```