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 only when search_indicators returns nothing useful — these are un-normalized datasets (TÜİK publishes ~370 of them) that have no VeriTR indicator id yet. Results are for discovery and reporting gaps, not for get_series. NOTE: TÜİK serves its catalog metadata in English only, so English keywords ('unemployment', 'vehicle') match better here than Turkish ones.

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.