Search VeriTR's normalized indicator catalog.

USE THIS FIRST, before get_series, whenever the exact indicator id is unknown. Returns VeriTR indicator ids (e.g. 'population.total') that get_series accepts. Search works in Turkish and English and is accent-insensitive.

Search the raw dataset catalogs of the source institutions.

Use this when search_indicators returns nothing useful, and always for city-level questions about İstanbul (transport, traffic, environment, culture, infrastructure) — İBB publishes ~560 municipal datasets that have no VeriTR indicator id. Follow up with get_dataset to read the rows. NOTE: TÜİK serves its catalog metadata in English only, so English keywords ('unemployment', 'vehicle') match better for TÜİK; İBB is indexed in Turkish.

Read the columns and rows of a raw dataset found via search_datasets.

This is the path for municipal (İBB) data, which is deliberately NOT mapped into the normalized indicator namespace — use get_series for national indicators and this for city datasets. Returns the field list, a page of rows, the total row count, and the source licence. Page with offset; the response says how many rows were withheld.

Fetch a time series for one indicator. This is the primary data tool.

Returns compact [period, value] pairs plus the source institution and dataset id. Omitting geography returns every region the indicator covers — combine with limit for national comparisons, or use get_snapshot for a single-year ranking.

Get one indicator's value across ALL regions at a single point in time, ranked.

Use this for "which provinces have the highest/lowest X" questions instead of calling get_series once per province.

Compare ONE indicator across SEVERAL regions over time.

Each region gets its own series plus a summary (first/last value, total change). For comparing several indicators instead, use compare_series.

Compare SEVERAL indicators — possibly from different institutions — side by side.

This is what makes cross-source questions answerable, e.g. TÜİK population against TCMB house prices. Frequency mismatches are reported explicitly and never silently resampled. Set normalize=true when units differ.

Get the full definition of an indicator: unit, frequency, geography coverage, which dimensions you may override in get_series, the source dataset, and the official URL. Call this when get_series arguments are unclear.

List every institution VeriTR can reach, with live availability status.

Use this when a query fails, to tell the user whether the problem is a missing API key, a provider outage, or an unsupported topic.

Run deterministic statistics over a single series (growth rates, moving average, rebasing to 100, min/max/mean). Prefer this over doing the arithmetic yourself when the series has many observations — it avoids transcription errors.