List BPS domains/regions (province, regency/city). Use type='prov' for provinces, 'kab' for all regencies, 'kabbyprov' for regencies per province.

Convert region name to BPS domain code. Supports official names, abbreviations (Jatim, Jabar, Jogja), and fuzzy matching.

List available BPS statistical data subjects for a given domain. Subjects are main data categories (e.g. Population, Poverty, Trade).

List BPS statistical subject categories. Categories group related subjects.

List data variables in BPS dynamic tables. Variables determine specific data you can retrieve (e.g. Population Count, Poverty Rate).

List vertical variables (breakdown/disaggregation) for a given variable. Examples: gender, age group.

List derived variables (aggregated categories). Examples: total, average.

List available data periods for a given variable. Periods can be years, semesters, quarters, or months.

List derived periods for a given variable.

List data units used in a given domain. Examples: Person, Percent, Rupiah.

Fetch data from BPS dynamic tables. This tool requires a specific variable ID.

IMPORTANT: Use find_data first for automatic search. Use this tool only if you already know the var_id.

Common variables (national, domain=0000):

• 1452: Population (thousand people)

• 185: Poverty Percentage

• 523: Open Unemployment Rate (%)

• 108: GDP Growth Rate (%)

• 1706: Human Development Index (HDI)

• 2103: Gini Ratio

Use find_variable to search for other variable IDs.

List BPS static tables. Static tables contain pre-formatted data in HTML table format.

Retrieve details of a single BPS static table (includes table content in HTML format).

List BPS Press Releases (Berita Resmi Statistik / BRS). BRS contains the latest official data releases.

Retrieve details of a single BPS Press Release (BRS).

List BPS publications. Publications contain in-depth analysis and statistical reports.

Retrieve details of a single BPS publication.

List BPS strategic indicators — latest headline data (inflation, economic growth, poverty, unemployment, HDI, exports/imports, etc.).

Use this tool for a quick summary of key indicators for a region. Data includes the latest value. For multi-year historical data, use find_data or get_dynamic_data.

Retrieve foreign trade data (exports/imports) by HS code. Data includes value and volume of Indonesia's trade.

List BPS infographics. Infographics contain easy-to-understand statistical data visualizations.

Retrieve details of a single BPS infographic including full description and download link.

List BPS census activities (Population Census, Economic Census, Agricultural Census, etc.). Use the activity ID to fetch census topics and data.

List data topics available for a specific census activity. Use list_census_events to get the activity ID.

List available areas/regions for a specific census activity. Use list_census_events to get the activity ID. Returns MFD codes used as wilayah_sensus in get_census_data.

List available datasets for a specific census activity and topic. Use list_census_events and list_census_topics first.

Fetch actual census data for a specific activity, area, and dataset. Use list_census_events, list_census_areas, and list_census_datasets first to get the required IDs.

List BPS CSA (Classification of Statistical Activities) categories. CSA is an international statistical activity classification.

List CSA subjects for a given domain and category.

List CSA tables for a given domain and subject.

Retrieve details of a single CSA table (includes table content in HTML format).

List 7-digit MFD codes for all provinces used in SIMDASI (Sistem Informasi Manajemen Data Statistik Terintegrasi). Use these codes as the 'wilayah' parameter for other SIMDASI tools.

List 7-digit MFD codes for regencies/cities in a province, used in SIMDASI. Use list_simdasi_provinces to get the parent MFD code.

List 7-digit MFD codes for districts in a regency, used in SIMDASI. Use list_simdasi_regencies to get the parent MFD code.

List SIMDASI subjects/chapters available for a specific area. Requires a 7-digit MFD wilayah code from list_simdasi_provinces.

List all SIMDASI master tables available in the system.

List SIMDASI tables available for a specific area. Requires a 7-digit MFD wilayah code from list_simdasi_provinces.

List SIMDASI tables filtered by area and subject. Requires wilayah (7-digit MFD) and id_subjek from list_simdasi_subjects.

Get detailed data from a SIMDASI table for a specific area and year. Requires wilayah (7-digit MFD), tahun (year), and id_tabel from list_simdasi_tables.

List Sustainable Development Goals (SDGs) indicators from BPS. Optionally filter by goal number (1-17). Each indicator has a var_id that can be used with get_dynamic_data to fetch actual values. Domain is always 0000 (National).

Fetch actual SDGs indicator data for a specific variable. Use list_sdgs first to find the var_id, then call this to get the data values.

List Special Data Dissemination Standard (SDDS) indicators from BPS. SDDS covers macroeconomic data following IMF standards. Each indicator has a var_id and model type ('data' or 'statictable') used to fetch actual values. Domain is always 0000 (National).

Fetch actual SDDS indicator data. Use list_sdds first to find the var_id and model type. For 'data' model, this fetches dynamic table data. For 'statictable' model, it fetches a static table.

List BPS statistical classification entries by model. Supports KBLI (2009/2015/2017/2020 — business classification based on ISIC) and KBKI (2015 — commodity classification). Use 'level' parameter to filter by hierarchy level.

Get detailed information about a specific statistical classification entry by its ID. Use list_classifications first to find the ID.

List BPS news categories (e.g., Sensus dan Survey, Statistik Lain). Use the category name as newscat filter in list_news.

List news from the BPS website. Unlike BRS (Official Statistics News), these are general BPS news items.

Retrieve details of a single news item from the BPS website.

Get detailed definition of a specific glossary term by its ID. Use list_glossary to find term IDs.

Search terms in the BPS statistical glossary. Useful for understanding definitions and meanings of statistical indicators.

Cross-type search across BPS content (static tables, publications, press releases, indicators).

When to use this tool:

• Searching for static tables or publications by topic

• Searching for the latest press releases (BRS)

• General search when find_data returns no results

When NOT to use this tool:

• If user asks for specific numeric data → use find_data

• If you already know the variable ID → use get_dynamic_data

If WebAPI finds no results, it automatically falls back to the AllStats Search Engine.

Search BPS content via AllStats Search Engine (publications, tables, press releases, infographics, microdata, glossary, classifications). IMPORTANT: This tool has high latency due to proxy/scraping. Use the 'search' tool first as it is much faster. Only use this tool if 'search' finds no results. No API key required.

Full-text search inside BPS PDF publications. Returns matching pages with text excerpts. Get publication_id from allstats_search results (deep_search_id field). Unique feature — not available via WebAPI. No API key required.

Search BPS data variables by keyword. Searches across all relevant subjects.

Usage examples:

• find_variable(keyword="penduduk") → variables related to population

• find_variable(keyword="kemiskinan", domain="3500") → poverty variables in East Java

• find_variable(keyword="inflasi") → national inflation variables

After getting a var_id from this tool, use get_dynamic_data to retrieve the data.

Primary AI tool: search and retrieve BPS data in one step. Automatically: detect intent → resolve region → find variable → fetch data.

Intent Detection (automatic):

• Single value (specific number) → find_data

• Comparison ("compare X and Y") → delegate to compare_data

• Trend ("trend 2019-2024") → delegate to get_trend

• Ranking ("top 10 poorest provinces") → delegate to get_ranking

• Table/Breakdown ("religion by subdistrict") → find_data + static table fallback

• Publication ("find publication") → delegate to search

Quick Reference — Common Topics

Strategy:

1. Latest headline figures → list_strategic_indicators

2. Historical/specific numeric data → find_data or get_dynamic_data + var_id above

3. Search publications/tables/BRS → search or allstats_search

4. Search text inside PDFs → allstats_deep_search

Examples:

• find_data(query="penduduk miskin", region="Indonesia", year="2023")

• find_data(query="pengangguran", region="Jawa Timur", year="2023")

• find_data(query="PDRB", region="Bali", year="2023")

• find_data(query="pemeluk agama", region="Kabupaten Jombang")

Compare statistical data across regions in one step. Use this tool when the user wants to compare data between 2 or more regions. Note: only supports comparison for 1 year. For multi-year comparison, use get_trend per region.

Example user queries suitable for this tool:

• "compare poverty in East Java and West Java"

• "HDI DKI Jakarta vs Banten vs West Java"

• "unemployment comparison across provinces in Java"

• "which has higher poverty East Java or West Java?"

Retrieve time-series data (multi-year trend) in one step. Use this tool when the user wants to see data trends year over year.

Example user queries suitable for this tool:

• "poverty trend Indonesia 2019-2023"

• "HDI development in East Java last 5 years"

• "how has unemployment been from 2020 to 2024?"

• "poverty data West Java year to year"

Retrieve province rankings by a given indicator in one step. Use this tool when the user wants to see rankings, top-N, or comparisons across all provinces.

Example user queries suitable for this tool:

• "10 poorest provinces in Indonesia"

• "HDI ranking across all provinces"

• "provinces with highest unemployment"

• "poverty ranking per province 2023"

• "5 provinces with the largest population"

Clear BPS data cache. Useful to ensure latest data is fetched directly from the API.