ilostat-mcp-server
Was dieses MCP kann
Queries, compares, describes, and analyzes ILOSTAT labour-market indicators, country profiles, reference codes, and staged dataframes.
Tools
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dataset_id'], 'properties': {'sex': {'enum': ['SEX_T', 'SEX_M', 'SEX_F', 'SEX_O'], 'type': 'string', 'description': 'Sex code SEX_T, SEX_M, SEX_F, or SEX_O; T/M/F/O and total/both/male/female/other are accepted. Defaults to SEX_T on a dataset with a sex breakdown; refused on one without.'}, 'sort': {'enum': ['value_desc', 'value_asc', 'ref_area'], 'type': 'string', 'default': 'value_desc', 'description': 'Row order: value_desc (default), value_asc, or ref_area. rank is always by value, highest first.'}, 'period': {'type': 'string', 'pattern': '^\\d{4}(Q[1-4]|M(0[1-9]|1[0-2]))?$', 'description': 'A common period, YYYY, YYYYQn, or YYYYMmm matching the dataset frequency (2024-Q2 and 2025-03 are normalized). Omit to compare each area at its latest period.'}, 'classif1': {'type': 'string', 'maxLength': 64, 'description': "First breakdown code, case-insensitive. Defaults to the dataset's total code; required when the breakdown has no total (deciles); refused on a dataset without the breakdown. ilostat_describe_indicator lists the dataset's codes and marks its totals."}, 'classif2': {'type': 'string', 'maxLength': 64, 'description': 'Second breakdown code; same defaults and rules as classif1.'}, 'ref_areas': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Z0-9]{3}$'}, 'maxItems': 300, 'description': 'Reference areas (up to 300): ISO3 codes (USA) or X-coded aggregates (X01 World); case-insensitive, ILO_GEO_ forms accepted. At least one of ref_areas or area_group is required.'}, 'area_group': {'type': 'string', 'pattern': '^[A-Z0-9]{3}$', 'description': "X01 for every country, an ILO region or subregion, or a World Bank income group (X06, X56, X02, â\x80¦); expands to its member countries. The group's own aggregate is compared only when listed in ref_areas. ilostat_list_reference topic area_groups lists the codes."}, 'dataset_id': {'type': 'string', 'pattern': '^[A-Z0-9_]+$', 'maxLength': 64, 'description': 'One dataset ID (UNE_DEAP_SEX_AGE_RT_A), as ilostat_search_indicators returns it; case-insensitive, a DF_ prefix (the SDMX dataflow form) stripped, a bare indicator code resolved when it has one frequency.'}, 'change_years': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': "Adds each value's change from the same sub-period this many years earlier, in the dataset unit."}, 'lookback_years': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': "Latest mode: an area's latest value must fall within this many years of the current year."}, 'include_projections': {'type': 'boolean', 'default': False, 'description': "Latest mode: let projections (ILO modelled values after the cutoff) be an area's latest value."}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['dataset', 'slice', 'mode', 'include_projections', 'rows', 'legend', 'missing', 'comparability', 'attribution', 'applied_filters', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'Inline preview budget, in serialized characters.'}, 'mode': {'enum': ['latest', 'period'], 'type': 'string', 'description': "latest: each area's latest value; period: every area at one period."}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['rank', 'ref_area', 'kind', 'value', 'period', 'basis', 'source', 'notes'], 'properties': {'kind': {'enum': ['country', 'aggregate'], 'type': 'string', 'description': 'country or X-coded aggregate.'}, 'rank': {'type': 'number', 'description': 'Rank by value, highest first; ties share a rank.'}, 'basis': {'enum': ['reported', 'modelled_estimate', 'projection'], 'type': 'string', 'description': 'reported, modelled_estimate, or projection.'}, 'label': {'type': 'string', 'description': 'Reference area label.'}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Note codes (legend.notes decodes them).'}, 'value': {'type': 'number', 'description': 'Value in the dataset unit.'}, 'change': {'type': 'object', 'required': ['from_period', 'from_value', 'delta'], 'properties': {'delta': {'type': 'number', 'description': 'value â\x88\x92 from_value, in the dataset unit.'}, 'from_value': {'type': 'number', 'description': 'The value at the earlier period.'}, 'from_period': {'type': 'string', 'description': 'The earlier period.'}}, 'description': 'Change over change_years; absent when the earlier value is missing.', 'additionalProperties': False}, 'period': {'type': 'string', 'description': 'Period of the value.'}, 'source': {'type': 'string', 'description': 'Source code.'}, 'ref_area': {'type': 'string', 'description': 'Reference area code.'}, 'obs_status': {'type': 'string', 'description': 'Observation status flag (legend.obs_status decodes it).'}, 'source_label': {'type': 'string', 'description': 'Source label.'}}, 'description': 'One area with a value.', 'additionalProperties': False}, 'description': 'Areas with a value, in the requested order; the staged dataframe holds all when larger.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['unknown_dataset', 'unknown_code', 'unknown_area_group', 'areas_required', 'aggregates_unavailable', 'invalid_slice', 'invalid_period', 'dataset_retired', 'structure_unavailable', 'upstream_busy', 'catalog_unavailable'], 'description': "Machine-readable failure mode. Declared by this tool: `unknown_dataset`: dataset_id is not in the catalog, or a bare indicator code has several frequencies. `unknown_code`: A ref_areas, sex, classif1, or classif2 value is not in the ILOSTAT dictionaries. `unknown_area_group`: area_group is not X01, an ILO region or subregion, or a World Bank income group. `areas_required`: Neither ref_areas nor area_group was given. `aggregates_unavailable`: An X-coded aggregate was requested from a dataset that has no aggregate rows. `invalid_slice`: A breakdown has no total code and no value was given, or sex/classif1/classif2 names a breakdown the dataset lacks. `invalid_period`: period is of a frequency other than the dataset's. `dataset_retired`: Upstream reports a catalog dataset ID as deprecated or invalid. `structure_unavailable`: classif1 or classif2 was left to its default and the ILOSTAT structure service could not supply the dataset total codes. `upstream_busy`: The server-side pacer shed the call, or the ILOSTAT API answered 429 or a challenge page. `catalog_unavailable`: No catalog snapshot has loaded and the load failed, or the first load has not finished within 30 s. Other values are possible when a failure originates below the handler."}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Rows returned inline.'}, 'slice': {'type': 'object', 'required': ['defaulted'], 'properties': {'sex': {'type': 'string', 'description': 'Sex code compared.'}, 'classif1': {'type': 'string', 'description': 'classif1 code compared.'}, 'classif2': {'type': 'string', 'description': 'classif2 code compared.'}, 'defaulted': {'type': 'array', 'items': {'enum': ['sex', 'classif1', 'classif2'], 'type': 'string'}, 'description': "Which slice codes were filled from the dataset's totals."}}, 'description': 'The one series compared per area.', 'additionalProperties': False}, 'legend': {'type': 'object', 'required': ['obs_status', 'notes'], 'properties': {'notes': {'type': 'object', 'description': 'Note code â\x86\x92 label, for every note code in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'obs_status': {'type': 'object', 'description': 'Observation status code â\x86\x92 label, for every status flag in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}}, 'description': 'Labels for the status flags and note codes in rows.', 'additionalProperties': False}, 'notice': {'type': 'string', 'description': 'Mixed periods, mixed bases, missing areas, a unit or area list the structure service could not supply, where the full comparison is staged, or why the inline rows stop early.'}, 'period': {'type': 'string', 'description': 'Period mode: the period compared.'}, 'dataset': {'type': 'object', 'required': ['dataset_id', 'label', 'frequency', 'database', 'last_update', 'has_aggregates', 'projection_after_year', 'projection_rule'], 'properties': {'unit': {'type': 'object', 'required': ['measure', 'type', 'multiplier'], 'properties': {'type': {'type': 'string', 'description': 'Unit type code (RT rate, NB number, â\x80¦).'}, 'measure': {'type': 'string', 'description': 'Unit code (PT percent, PS persons, LC local currency, â\x80¦).'}, 'multiplier': {'type': 'number', 'description': 'Power of ten values are expressed in: 0 units, 3 thousands, 6 millions.'}, 'type_label': {'type': 'string', 'description': 'Unit type label.'}, 'measure_label': {'type': 'string', 'description': 'Unit label.'}, 'multiplier_label': {'type': 'string', 'description': 'Multiplier label.'}}, 'description': 'Unit of the values, already in the multiplier scale; absent when unresolved.', 'additionalProperties': False}, 'label': {'type': 'string', 'description': 'Dataset label as ILOSTAT publishes it.'}, 'edition': {'type': 'string', 'description': 'The edition the cutoff derives from, e.g. Nov. 2025.'}, 'database': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'Database code.'}, 'label': {'type': 'string', 'description': 'Database label.'}}, 'description': 'Source database.', 'additionalProperties': False}, 'frequency': {'type': 'string', 'description': 'A (annual), Q (quarterly), or M (monthly).'}, 'dataset_id': {'type': 'string', 'description': 'Dataset ID.'}, 'last_update': {'type': 'string', 'description': 'Last upstream update, ISO 8601 without zone offset.'}, 'has_aggregates': {'type': 'boolean', 'description': 'Whether the dataset carries World, regional, or income-group rows.'}, 'projection_rule': {'enum': ['edition', 'catalog_edition', 'current_year'], 'type': 'string', 'description': "How the cutoff was set: the label's edition, the catalog's latest ILO modelled estimates edition, or the year before the current year."}, 'projection_after_year': {'type': 'number', 'description': 'Last year counted as an estimate; modelled rows after it are classed projection.'}}, 'description': 'One requested dataset and how its values are classed.', 'additionalProperties': False}, 'missing': {'type': 'array', 'items': {'type': 'object', 'required': ['ref_area', 'reason'], 'properties': {'label': {'type': 'string', 'description': 'Reference area label.'}, 'reason': {'enum': ['no_value_in_window', 'no_value_for_period', 'not_covered'], 'type': 'string', 'description': "no_value_in_window (latest mode), no_value_for_period (period mode), or not_covered (absent from the dataset's area list; never given when that list is unavailable, which notice says)."}, 'ref_area': {'type': 'string', 'description': 'Reference area code.'}}, 'description': 'One area without a value.', 'additionalProperties': False}, 'description': 'Requested areas with no value, and why.'}, 'dataframe': {'type': 'object', 'required': ['name', 'row_count', 'expires_at'], 'properties': {'name': {'type': 'string', 'description': 'Staged dataframe name (df_XXXXX_XXXXX) for ilostat_dataframe_query SQL.'}, 'evicted': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Dataframes dropped, oldest first, to keep this tenant within 1,000,000 staged rows and 100 dataframes; present only when staging this one evicted any.'}, 'row_count': {'type': 'number', 'description': 'Rows staged.'}, 'expires_at': {'type': 'string', 'description': 'ISO 8601 expiry of the staged dataframe.'}}, 'description': 'The staged dataframe holding the full result; present only when staged.', 'additionalProperties': False}, 'truncated': {'type': 'boolean', 'description': 'True when the inline rows stop before the last area â\x80\x94 also when a dataframe holds the full comparison.'}, 'attribution': {'type': 'string', 'description': 'Citation to keep with any use of the data.'}, 'window_from': {'type': 'number', 'description': 'Latest mode: the first year requested â\x80\x94 lookback_years before the current year, and change_years further back to reach the change base. A latest value still falls within lookback_years.'}, 'change_years': {'type': 'number', 'description': 'Years the change is measured over, when requested.'}, 'comparability': {'type': 'object', 'required': ['periods', 'mixed_periods', 'basis_counts', 'distinct_sources'], 'properties': {'periods': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Distinct periods of the values, newest first.'}, 'basis_counts': {'type': 'object', 'required': ['reported', 'modelled_estimate', 'projection'], 'properties': {'reported': {'type': 'number', 'description': 'Values from a national or institutional source.'}, 'projection': {'type': 'number', 'description': 'ILO modelled values after the cutoff.'}, 'modelled_estimate': {'type': 'number', 'description': 'ILO modelled estimates up to the cutoff.'}}, 'description': 'Values per basis.', 'additionalProperties': False}, 'mixed_periods': {'type': 'boolean', 'description': 'True when the values span more than one period.'}, 'distinct_sources': {'type': 'number', 'description': 'Distinct sources behind the values.'}}, 'description': 'What makes the values more or less comparable, over every area.', 'additionalProperties': False}, 'applied_filters': {'type': 'object', 'required': ['dataset_id', 'ref_area_count', 'best_source'], 'properties': {'sex': {'type': 'string', 'description': 'Sex code sent.'}, 'time': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Exact periods sent (period mode).'}, 'classif1': {'type': 'string', 'description': 'classif1 code sent.'}, 'classif2': {'type': 'string', 'description': 'classif2 code sent.'}, 'ref_areas': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Reference areas given, normalized.'}, 'time_from': {'type': 'number', 'description': 'First year sent (latest mode); no end year is sent.'}, 'area_group': {'type': 'object', 'required': ['code', 'label', 'member_count'], 'properties': {'code': {'type': 'string', 'description': 'Area group code.'}, 'label': {'type': 'string', 'description': 'Area group label.'}, 'member_count': {'type': 'number', 'description': 'Member countries it expanded to.'}}, 'description': 'The area group and how many countries it expanded to.', 'additionalProperties': False}, 'dataset_id': {'type': 'string', 'description': 'Dataset compared.'}, 'best_source': {'type': 'string', 'const': 'upstream default (yes)', 'description': 'best_source is never sent, so upstream returns the preferred source.'}, 'ref_area_count': {'type': 'number', 'description': 'Areas compared: ref_areas plus the area_group members.'}}, 'description': 'Every parameter sent upstream.', 'additionalProperties': False}, 'include_projections': {'type': 'boolean', 'description': "Whether a projection could be an area's latest value."}}, 'additionalProperties': False}
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'name': {'type': 'string', 'pattern': '^df_[A-Z0-9]{5}_[A-Z0-9]{5}$', 'description': 'One dataframe name as the producing tool returned it (df_XXXXX_XXXXX: letters and digits, five in each part; case-insensitive, as in SQL). Omit to list every staged dataframe; a deployment whose callers share one canvas refuses the listing and needs the name.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['dataframes']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['canvas_unavailable', 'listing_unavailable'], 'description': 'Machine-readable failure mode. Declared by this tool: `canvas_unavailable`: The DataCanvas DuckDB engine cannot load in this deployment. `listing_unavailable`: name is omitted where every caller shares one canvas (HTTP with auth none). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Guidance when the named dataframe does not exist.'}, 'dataframes': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'source_tool', 'query_params', 'created_at', 'expires_at', 'row_count', 'datasets', 'attribution', 'column_schema'], 'properties': {'name': {'type': 'string', 'description': 'Dataframe name, the table to use in SQL.'}, 'coverage': {'type': 'object', 'required': ['ref_areas'], 'properties': {'ref_areas': {'type': 'number', 'description': 'Distinct reference areas.'}, 'period_max': {'type': 'string', 'description': 'Latest period.'}, 'period_min': {'type': 'string', 'description': 'Earliest period.'}}, 'description': 'Areas and periods covered; absent for a dataframe derived by SQL.', 'additionalProperties': False}, 'datasets': {'type': 'array', 'items': {'type': 'object', 'required': ['dataset_id', 'label', 'last_update'], 'properties': {'unit': {'type': 'string', 'description': 'Unit label, when resolved.'}, 'label': {'type': 'string', 'description': 'Dataset label.'}, 'dataset_id': {'type': 'string', 'description': 'Dataset ID.'}, 'last_update': {'type': 'string', 'description': 'Last upstream update of the dataset.'}}, 'description': 'One dataset the dataframe holds.', 'additionalProperties': False}, 'description': 'Datasets the rows come from.'}, 'row_count': {'type': 'number', 'description': 'Rows staged.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation time.'}, 'expires_at': {'type': 'string', 'description': 'ISO 8601 expiry.'}, 'attribution': {'type': 'string', 'description': 'Citation to keep with any use of the data.'}, 'source_tool': {'type': 'string', 'description': 'Tool that produced it.'}, 'basis_counts': {'type': 'object', 'required': ['reported', 'modelled_estimate', 'projection'], 'properties': {'reported': {'type': 'number', 'description': 'Values from a national or institutional source.'}, 'projection': {'type': 'number', 'description': 'ILO modelled values after the cutoff.'}, 'modelled_estimate': {'type': 'number', 'description': 'ILO modelled estimates up to the cutoff.'}}, 'description': 'Rows per basis; absent for a dataframe derived by SQL.', 'additionalProperties': False}, 'query_params': {'type': 'object', 'description': "How the dataframe was produced: the producing tool's applied_filters, or {sql, derived_from} for a dataframe stored by ilostat_dataframe_query register_as.", 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'column_schema': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'type', 'nullable'], 'properties': {'name': {'type': 'string', 'description': 'Column name.'}, 'type': {'type': 'string', 'description': 'Column type (VARCHAR, INTEGER, DOUBLE, BOOLEAN, â\x80¦).'}, 'nullable': {'type': 'boolean', 'description': 'Whether the column permits NULL.'}}, 'description': 'One column.', 'additionalProperties': False}, 'description': 'Columns the SQL can reference.'}}, 'description': 'One staged dataframe.', 'additionalProperties': False}, 'description': 'Staged dataframes, newest first; empty when none.'}}, 'additionalProperties': False}
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['sql'], 'properties': {'sql': {'type': 'string', 'maxLength': 20000, 'minLength': 1, 'description': 'One SELECT over df_<id> tables (DuckDB SQL: joins, aggregates, window functions, CTEs), at most 20,000 characters. BIGINT results such as COUNT or SUM of integers serialize as strings; CAST to DOUBLE for inline arithmetic.'}, 'preview': {'type': 'integer', 'maximum': 10000, 'minimum': 0, 'description': 'Rows returned inline; defaults to row_limit. Set lower when register_as keeps the full result.'}, 'row_limit': {'type': 'integer', 'default': 1000, 'maximum': 10000, 'minimum': 1, 'description': 'Hard cap on rows materialized (1â\x80\x9310,000). A query matching more stops at the cap and row_count_capped is true; register_as keeps the full result.'}, 'register_as': {'type': 'string', 'pattern': '^df_[A-Z0-9]{5}_[A-Z0-9]{5}$', 'description': 'Store the result as a new dataframe under this name (df_XXXXX_XXXXX: letters and digits, five in each part; stored uppercased after df_) with a fresh TTL, to chain analyses. A result over 1,000,000 rows is refused, and storing one can evict the oldest dataframes, which evicted names.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['columns', 'row_count', 'row_count_capped', 'rows', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The row cap that bound: preview when lower than row_limit, else row_limit.'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'description': 'Result rows keyed by the names in columns, bounded by preview and row_limit; BIGINT values arrive as strings.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['canvas_unavailable', 'system_catalog_access', 'missing_table', 'invalid_sql', 'sql_execution_error', 'register_as_clash', 'register_as_too_large', 'non_select_statement', 'multi_statement', 'denied_function', 'plan_operator_not_allowed'], 'description': 'Machine-readable failure mode. Declared by this tool: `canvas_unavailable`: The DataCanvas DuckDB engine cannot load in this deployment. `system_catalog_access`: The SQL references a system catalog. `missing_table`: A referenced df_<id> does not exist or has expired. `invalid_sql`: The SELECT fails to prepare: an unknown column or an invalid expression. `sql_execution_error`: The SELECT prepared but failed on the data. `register_as_clash`: register_as names an existing dataframe. `register_as_too_large`: The register_as result holds more than 1,000,000 rows. `non_select_statement`: The SQL is not a SELECT. `multi_statement`: The SQL holds more than one statement, or a PIVOT with no IN list, which DuckDB expands into several. `denied_function`: The SQL calls a file-reading or external table function. `plan_operator_not_allowed`: The plan uses an operator outside the read-only allowlist, such as range(). Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Rows returned inline.'}, 'notice': {'type': 'string', 'description': 'Guidance when the query returned no rows or a cap withheld some.'}, 'columns': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Column names in projection order.'}, 'evicted': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Dataframes dropped, oldest first, to keep this tenant within 1,000,000 staged rows and 100 dataframes; present only when storing the result evicted any.'}, 'row_count': {'type': 'number', 'description': 'Rows the query produced. With register_as this is the exact count of the stored dataframe, which row_limit does not bound; otherwise at most row_limit, and when row_count_capped is true it is the cap, not a total.'}, 'truncated': {'type': 'boolean', 'description': 'True when a cap withheld rows from this response.'}, 'expires_at': {'type': 'string', 'description': 'ISO 8601 expiry of the new dataframe.'}, 'registered_as': {'type': 'string', 'description': 'The new dataframe name, when register_as stored the result.'}, 'row_count_capped': {'type': 'boolean', 'description': 'True when the query matched more rows than row_limit; never true with register_as, which stores every row.'}}, 'additionalProperties': False}
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dataset_id'], 'properties': {'dataset_id': {'type': 'string', 'pattern': '^[A-Z0-9_]+( *[+,] *[A-Z0-9_]+)*$', 'maxLength': 200, 'description': 'One dataset ID (indicator code plus _A, _Q, or _M, e.g. UNE_DEAP_SEX_AGE_RT_A) or a bare indicator code (UNE_DEAP_SEX_AGE_RT), as ilostat_search_indicators returns them. Case-insensitive; a DF_ prefix (the SDMX dataflow form) is stripped.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['found', 'catalog_as_of']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'unit': {'type': 'object', 'required': ['measure', 'type', 'multiplier'], 'properties': {'type': {'type': 'string', 'description': 'Unit type code (RT rate, NB number, â\x80¦).'}, 'measure': {'type': 'string', 'description': 'Unit code (PT percent, PS persons, LC local currency, â\x80¦).'}, 'multiplier': {'type': 'number', 'description': 'Power of ten values are expressed in: 0 units, 3 thousands, 6 millions.'}, 'type_label': {'type': 'string', 'description': 'Unit type label.'}, 'measure_label': {'type': 'string', 'description': 'Unit label.'}, 'multiplier_label': {'type': 'string', 'description': 'Multiplier label.'}}, 'description': 'Unit of the values, already in the multiplier scale; absent when unresolved.', 'additionalProperties': False}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['catalog_unavailable'], 'description': 'Machine-readable failure mode. Declared by this tool: `catalog_unavailable`: No catalog snapshot has loaded and the load failed, or the first load has not finished within 30 s. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'found': {'type': 'boolean', 'description': 'False when no dataset or indicator has the code.'}, 'label': {'type': 'string', 'description': 'Indicator label as ILOSTAT publishes it.'}, 'notice': {'type': 'string', 'description': 'Where to find breakdown codes and units when the structure service did not supply them.'}, 'measure': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'Measure (the quantity measured, shared by breakdown variants) code.'}, 'label': {'type': 'string', 'description': 'Measure (the quantity measured, shared by breakdown variants) label.'}}, 'description': 'Measure (the quantity measured, shared by breakdown variants) code and label.', 'additionalProperties': False}, 'subject': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'Subject code.'}, 'label': {'type': 'string', 'description': 'Subject label.'}}, 'description': 'Subject code and label.', 'additionalProperties': False}, 'database': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'Source database code.'}, 'label': {'type': 'string', 'description': 'Source database label.'}}, 'description': 'Source database code and label.', 'additionalProperties': False}, 'datasets': {'type': 'array', 'items': {'type': 'object', 'required': ['dataset_id', 'frequency', 'data_start', 'data_end', 'n_ref_area', 'n_records', 'n_records_all', 'last_update', 'has_aggregates'], 'properties': {'data_end': {'type': 'number', 'description': 'Last year with data (can include projection years).'}, 'frequency': {'type': 'string', 'description': 'A (annual), Q (quarterly), or M (monthly).'}, 'n_records': {'type': 'number', 'description': 'Best-source observations an unfiltered download returns.'}, 'data_start': {'type': 'number', 'description': 'First year with data.'}, 'dataset_id': {'type': 'string', 'description': 'Dataset ID.'}, 'n_ref_area': {'type': 'number', 'description': 'Reference areas with data.'}, 'last_update': {'type': 'string', 'description': 'Last upstream update, ISO 8601 without zone offset.'}, 'n_records_all': {'type': 'number', 'description': 'Observations including secondary sources.'}, 'has_aggregates': {'type': 'boolean', 'description': 'Whether this dataset carries World, regional, or income-group rows.'}}, 'description': 'One frequency variant of the indicator.', 'additionalProperties': False}, 'description': 'Every frequency variant of the indicator, annual first.'}, 'guidance': {'type': 'string', 'description': 'On a miss: how to find a valid dataset ID.'}, 'indicator': {'type': 'string', 'description': 'Indicator code.'}, 'ref_areas': {'type': 'object', 'required': ['countries', 'aggregates', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Reference areas with data.'}, 'countries': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Country codes with data.'}, 'aggregates': {'type': 'array', 'items': {'type': 'string'}, 'description': 'X-coded aggregate codes with data.'}}, 'description': "Reference areas the indicator covers across its frequencies, from ILOSTAT's structure service; absent when structure_status is unavailable.", 'additionalProperties': False}, 'basis_rule': {'type': 'object', 'required': ['modelled_source_label', 'projection_after_year', 'projection_rule', 'database_is_modelled'], 'properties': {'edition': {'type': 'string', 'description': 'The edition the cutoff derives from, e.g. Nov. 2025.'}, 'projection_rule': {'enum': ['edition', 'catalog_edition', 'current_year'], 'type': 'string', 'description': "How the cutoff was set: the label's edition, the catalog's latest ILO modelled estimates edition, or the year before the current year."}, 'database_is_modelled': {'type': 'boolean', 'description': 'Whether the whole database is the ILO modelled estimates (ILOEST).'}, 'modelled_source_label': {'type': 'string', 'description': 'Source label that marks an observation as an ILO modelled estimate.'}, 'projection_after_year': {'type': 'number', 'description': 'Last year counted as an estimate; later modelled years are projections.'}}, 'description': 'How observations are classed reported, modelled_estimate, or projection.', 'additionalProperties': False}, 'breakdowns': {'type': 'object', 'required': ['sex', 'sex_codes'], 'properties': {'sex': {'type': 'boolean', 'description': 'Whether the dataset has a sex breakdown.'}, 'classif1': {'type': 'object', 'required': ['type', 'codes'], 'properties': {'type': {'type': 'string', 'description': 'Classification type of classif1 (e.g. AGE, ECO, DCL).'}, 'codes': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'label', 'is_total'], 'properties': {'code': {'type': 'string', 'description': 'Code to pass as classif1.'}, 'label': {'type': 'string', 'description': 'Code label.'}, 'is_total': {'type': 'boolean', 'description': 'Whether the code is the total of its breakdown.'}}, 'description': 'One breakdown code.', 'additionalProperties': False}, 'description': "Codes ILOSTAT's structure service lists for this breakdown that ilostat_query_indicator accepts as classif1; classification group headers excluded. The list covers every frequency of the indicator, so a code may have no rows in one dataset."}, 'type_label': {'type': 'string', 'description': 'Classification type label.'}}, 'description': 'The classif1 breakdown.', 'additionalProperties': False}, 'classif2': {'type': 'object', 'required': ['type', 'codes'], 'properties': {'type': {'type': 'string', 'description': 'Classification type of classif2 (e.g. AGE, ECO, DCL).'}, 'codes': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'label', 'is_total'], 'properties': {'code': {'type': 'string', 'description': 'Code to pass as classif2.'}, 'label': {'type': 'string', 'description': 'Code label.'}, 'is_total': {'type': 'boolean', 'description': 'Whether the code is the total of its breakdown.'}}, 'description': 'One breakdown code.', 'additionalProperties': False}, 'description': "Codes ILOSTAT's structure service lists for this breakdown that ilostat_query_indicator accepts as classif2; classification group headers excluded. The list covers every frequency of the indicator, so a code may have no rows in one dataset."}, 'type_label': {'type': 'string', 'description': 'Classification type label.'}}, 'description': 'The classif2 breakdown.', 'additionalProperties': False}, 'sex_codes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Sex codes the dataset uses (SEX_T total).'}}, 'description': "Breakdown codes in use, from ILOSTAT's structure service; absent when structure_status is unavailable.", 'additionalProperties': False}, 'dataset_id': {'type': 'string', 'description': 'The dataset requested, when a dataset ID (not a bare indicator code) was given.'}, 'definition': {'type': 'string', 'description': 'ILOSTAT definition of the indicator, HTML stripped; links kept as "text (url)".'}, 'attribution': {'type': 'string', 'description': 'Citation to keep with any use of the data.'}, 'catalog_as_of': {'type': 'string', 'description': 'ISO timestamp the catalog was last confirmed current.'}, 'default_slice': {'type': 'object', 'properties': {'sex': {'type': 'string', 'description': 'Default sex code.'}, 'classif1': {'type': 'string', 'description': 'Default classif1 code.'}, 'classif2': {'type': 'string', 'description': 'Default classif2 code.'}}, 'description': "The dataset's total codes from its default view â\x80\x94 the slice ilostat_compare_geographies uses when sex, classif1, or classif2 is omitted; a breakdown with no total (deciles) is left out.", 'additionalProperties': False}, 'has_aggregates': {'type': 'boolean', 'description': 'Whether the requested dataset (or, for an indicator code, any of its datasets) carries World, regional, or income-group rows.'}, 'related_datasets': {'type': 'array', 'items': {'type': 'object', 'required': ['indicator', 'label'], 'properties': {'label': {'type': 'string', 'description': 'Indicator label.'}, 'indicator': {'type': 'string', 'description': 'Indicator code.'}, 'classification': {'type': 'string', 'description': 'Its breakdown classification.'}}, 'description': 'An indicator measuring the same quantity.', 'additionalProperties': False}, 'description': 'Up to 20 other indicators sharing this measure under other breakdowns.'}, 'structure_status': {'enum': ['complete', 'unavailable'], 'type': 'string', 'description': "unavailable when ILOSTAT's structure service has no entry for the indicator or cannot be reached; breakdowns, default_slice, unit, and ref_areas are then absent."}}, 'additionalProperties': False}
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ref_area'], 'properties': {'sex': {'enum': ['SEX_T', 'SEX_M', 'SEX_F'], 'type': 'string', 'default': 'SEX_T', 'description': 'SEX_T (default), SEX_M, or SEX_F; T/M/F and total/both/male/female are accepted. Indicators without a sex breakdown (labour income share) are unaffected.'}, 'ref_area': {'type': 'string', 'pattern': '^[A-Z0-9]{3}$', 'description': 'One reference area with annual data: an ISO3 country code (KEN) or an X-coded aggregate (X01 World, X06, X02); ILO_GEO_ forms accepted, case-insensitive. ilostat_list_reference topic ref_areas lists them.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['ref_area', 'sex', 'indicators', 'reported_missing', 'modelled_cutoff_year', 'catalog_as_of', 'attribution']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'sex': {'type': 'string', 'description': 'Sex code profiled.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['unknown_area', 'upstream_busy', 'catalog_unavailable'], 'description': 'Machine-readable failure mode. Declared by this tool: `unknown_area`: ref_area is not an ILOSTAT reference area with annual data. `upstream_busy`: The server-side pacer shed the call, or the ILOSTAT API answered 429 or a challenge page. `catalog_unavailable`: No catalog snapshot has loaded and the load failed, or the first load has not finished within 30 s. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'notice': {'type': 'string', 'description': 'Which indicators have no reported value, and which of those have an ILO modelled estimate instead.'}, 'ref_area': {'type': 'object', 'required': ['code', 'label', 'kind'], 'properties': {'code': {'type': 'string', 'description': 'Reference area code.'}, 'kind': {'enum': ['country', 'aggregate'], 'type': 'string', 'description': 'country or X-coded aggregate.'}, 'label': {'type': 'string', 'description': 'Reference area label.'}, 'region': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'ILO region code (X-coded).'}, 'label': {'type': 'string', 'description': 'ILO region label.'}}, 'description': 'ILO region the area belongs to.', 'additionalProperties': False}, 'subregion': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'ILO broad subregion code (X-coded).'}, 'label': {'type': 'string', 'description': 'ILO broad subregion label.'}}, 'description': 'ILO broad subregion the area belongs to.', 'additionalProperties': False}, 'income_group': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'World Bank income group code (X-coded).'}, 'label': {'type': 'string', 'description': 'World Bank income group label.'}}, 'description': 'World Bank income group the area belongs to.', 'additionalProperties': False}}, 'description': 'The area profiled.', 'additionalProperties': False}, 'indicators': {'type': 'array', 'items': {'type': 'object', 'required': ['key', 'label', 'unit'], 'properties': {'key': {'type': 'string', 'description': 'Headline key, e.g. unemployment_rate.'}, 'unit': {'type': 'string', 'description': 'Unit of both values (% or thousands).'}, 'label': {'type': 'string', 'description': 'Headline label.'}, 'modelled': {'type': 'object', 'required': ['dataset_id', 'period', 'basis'], 'properties': {'basis': {'type': 'string', 'const': 'modelled_estimate', 'description': 'Always modelled_estimate: projections are excluded.'}, 'value': {'type': 'number', 'description': 'Value; absent when upstream sent none.'}, 'period': {'type': 'string', 'description': 'Period of the value.'}, 'edition': {'type': 'string', 'description': 'Modelled estimates edition, e.g. Nov. 2025.'}, 'dataset_id': {'type': 'string', 'description': 'Modelled dataset the value comes from.'}, 'obs_status': {'type': 'string', 'description': 'Observation status flag.'}, 'obs_status_label': {'type': 'string', 'description': 'Status flag label.'}}, 'description': 'Latest non-projected ILO modelled estimate; absent when none exists.', 'additionalProperties': False}, 'reported': {'type': 'object', 'required': ['dataset_id', 'period', 'source', 'notes'], 'properties': {'notes': {'type': 'array', 'items': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'Note code.'}, 'label': {'type': 'string', 'description': 'Note label.'}}, 'description': 'One note attached to the value.', 'additionalProperties': False}, 'description': 'Notes attached to the value.'}, 'value': {'type': 'number', 'description': 'Value; absent when upstream sent none.'}, 'period': {'type': 'string', 'description': 'Period of the value.'}, 'source': {'type': 'string', 'description': 'Source code.'}, 'dataset_id': {'type': 'string', 'description': 'Dataset the value comes from.'}, 'obs_status': {'type': 'string', 'description': 'Observation status flag.'}, 'source_label': {'type': 'string', 'description': 'Source label.'}, 'obs_status_label': {'type': 'string', 'description': 'Status flag label.'}}, 'description': 'Latest reported value; absent when none exists.', 'additionalProperties': False}}, 'description': 'One headline indicator.', 'additionalProperties': False}, 'description': 'The headline indicators, in a fixed order.'}, 'attribution': {'type': 'string', 'description': 'Citation to keep with any use of the data.'}, 'catalog_as_of': {'type': 'string', 'description': 'ISO timestamp the catalog was last confirmed current.'}, 'reported_missing': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Keys with no reported value, including those that have no reported dataset.'}, 'modelled_cutoff_year': {'type': 'number', 'description': 'Latest year the modelled values could come from; later modelled years are projections.'}}, 'additionalProperties': False}
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['topic'], 'properties': {'codes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64}, 'maxItems': 100, 'description': 'Exact codes to look up (up to 100; case-insensitive, and ILO_GEO_ forms accepted for ref_areas and area_groups). Codes the topic lacks are listed in not_found. With topic area_groups, each group found also lists its member countries.'}, 'limit': {'type': 'integer', 'default': 50, 'maximum': 500, 'minimum': 1, 'description': 'Entries per page (1â\x80\x93500).'}, 'topic': {'enum': ['ref_areas', 'area_groups', 'databases', 'subjects', 'sexes', 'classifications', 'classification_types', 'sources', 'obs_status', 'notes', 'frequencies'], 'type': 'string', 'description': 'Vocabulary to list: ref_areas, area_groups (the X codes area_group accepts), databases, subjects, sexes, classifications (classif1/classif2 codes), classification_types, sources, obs_status, notes, or frequencies.'}, 'cursor': {'type': 'string', 'maxLength': 256, 'description': "Opaque continuation token: the previous page's next_cursor, passed unchanged."}, 'filter': {'type': 'string', 'maxLength': 200, 'description': 'Text filter: every word must match a word or word prefix of the code or label (case, accents, and punctuation ignored; labor matches labour). Omit to list the whole topic.'}, 'ref_area': {'type': 'string', 'pattern': '^[A-Z0-9]{3}$', 'description': 'Topic sources only: list the sources of this reference area (ISO3 or X code; case-insensitive, ILO_GEO_ forms accepted).'}, 'classification_type': {'type': 'string', 'maxLength': 32, 'description': 'Topic classifications only: keep codes of this classification type, the code prefix (AGE, ECO, EDU, â\x80¦).'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['topic', 'entries', 'total', 'catalog_as_of', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit applied to this page.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['unknown_code', 'param_not_for_topic', 'invalid_cursor', 'catalog_unavailable'], 'description': 'Machine-readable failure mode. Declared by this tool: `unknown_code`: ref_area is not an ILOSTAT reference area. `param_not_for_topic`: ref_area with a topic other than sources, or classification_type with a topic other than classifications. `invalid_cursor`: cursor does not decode. `catalog_unavailable`: No catalog snapshot has loaded and the load failed, or the first load has not finished within 30 s. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Entries returned on this page.'}, 'topic': {'enum': ['ref_areas', 'area_groups', 'databases', 'subjects', 'sexes', 'classifications', 'classification_types', 'sources', 'obs_status', 'notes', 'frequencies'], 'type': 'string', 'description': 'The topic listed.'}, 'total': {'type': 'number', 'description': 'Entries matching the filters, across all pages.'}, 'notice': {'type': 'string', 'description': 'Why a filter with no searchable word was not applied, why nothing matched, that the cursor starts past the last entry, and how to reach the remaining pages â\x80\x94 whichever apply, joined.'}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'The code other ILOSTAT tools take.'}, 'kind': {'enum': ['country', 'aggregate'], 'type': 'string', 'description': 'ref_areas: country, or an X-coded aggregate (World, region, income group).'}, 'slot': {'enum': ['classif1', 'classif2', 'both'], 'type': 'string', 'description': 'classifications: the query parameter slot the code is used in.'}, 'label': {'type': 'string', 'description': 'English label published by ILOSTAT.'}, 'members': {'type': 'array', 'items': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'ISO3 code of the member country.'}, 'label': {'type': 'string', 'description': 'Country name published by ILOSTAT.'}}, 'description': 'One member country.', 'additionalProperties': False}, 'description': 'area_groups looked up by exact codes only: the member countries, by code. A listing without codes gives member_count alone.'}, 'data_end': {'type': 'number', 'description': 'ref_areas: last year with data, any frequency.'}, 'ref_area': {'type': 'string', 'description': 'sources: the reference area the source belongs to.'}, 'note_type': {'type': 'string', 'description': 'notes: note_source, note_indicator, or note_classif.'}, 'data_start': {'type': 'number', 'description': 'ref_areas: first year with data, any frequency.'}, 'ilo_region': {'type': 'string', 'description': 'ref_areas: ILO region, as its X code.'}, 'frequencies': {'type': 'array', 'items': {'type': 'string'}, 'description': 'ref_areas: frequencies with data for the area (A annual, Q quarterly, M monthly).'}, 'group_types': {'type': 'array', 'items': {'enum': ['world', 'region', 'subregion_broad', 'subregion_detailed', 'income_group'], 'type': 'string'}, 'description': 'area_groups: which grouping levels use the code (world is X01, every country); one code can serve several.'}, 'source_type': {'type': 'string', 'description': 'sources: the label prefix before " - " (LFS, PC, ADM, ILO, OE, â\x80¦).'}, 'income_group': {'type': 'string', 'description': 'ref_areas: World Bank income group, as its X code.'}, 'member_count': {'type': 'number', 'description': 'area_groups: member countries.'}, 'dataset_count': {'type': 'number', 'description': 'Datasets using the code: per database, subject, or frequency; for ref_areas, datasets with data for the area summed over frequencies.'}, 'ilo_region_label': {'type': 'string', 'description': 'ref_areas: ILO region label.'}, 'income_group_label': {'type': 'string', 'description': 'ref_areas: income group label.'}, 'classification_type': {'type': 'string', 'description': 'classifications: the code prefix naming its classification type (AGE, ECO, â\x80¦).'}, 'ilo_subregion_broad': {'type': 'string', 'description': 'ref_areas: broad ILO subregion, as its X code.'}, 'ilo_subregion_detailed': {'type': 'string', 'description': 'ref_areas: detailed ILO subregion, as its X code.'}, 'ilo_subregion_broad_label': {'type': 'string', 'description': 'ref_areas: broad ILO subregion label.'}, 'ilo_subregion_detailed_label': {'type': 'string', 'description': 'ref_areas: detailed ILO subregion label.'}}, 'description': 'One decoded code; fields beyond code and label depend on the topic.', 'additionalProperties': False}, 'description': "This page of decoded codes, ordered by code â\x80\x94 except sexes, which keep the ILOSTAT dictionary's order (SEX_T first), and frequencies, listed annual, quarterly, monthly."}, 'not_found': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Requested codes the topic does not contain; present only when codes missed.'}, 'truncated': {'type': 'boolean', 'description': 'True when more entries remain beyond this page.'}, 'next_cursor': {'type': 'string', 'description': 'Pass as cursor to get the next page; absent on the last page.'}, 'catalog_as_of': {'type': 'string', 'description': 'ISO timestamp the in-memory catalog was last confirmed current.'}}, 'additionalProperties': False}
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['dataset_ids'], 'properties': {'sex': {'type': 'array', 'items': {'enum': ['SEX_T', 'SEX_M', 'SEX_F', 'SEX_O'], 'type': 'string'}, 'maxItems': 4, 'description': 'Sex codes SEX_T, SEX_M, SEX_F, SEX_O; T/M/F/O and total/both/male/female/other are accepted.'}, 'time': {'type': 'string', 'pattern': '^\\d{4}(Q[1-4]|M(0[1-9]|1[0-2]))?$', 'description': 'One exact period: YYYY (on a quarterly or monthly dataset, every period of that year), YYYYQn, or YYYYMmm; 2024-Q2, 2024 Q2, and 2025-03 are normalized. Not combinable with time_from, time_to, or latest_only.'}, 'sources': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64}, 'maxItems': 100, 'description': "Source codes (e.g. BA:453); ilostat_list_reference topic sources with ref_area lists an area's sources. Without source_selection, setting sources switches it to all, since a secondary source matches nothing under best."}, 'time_to': {'type': 'string', 'pattern': '^\\d{4}$', 'description': 'Last year (YYYY), not before time_from.'}, 'classif1': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64}, 'maxItems': 100, 'description': 'Codes of the first breakdown (e.g. AGE_YTHADULT_YGE15); case-insensitive. ilostat_describe_indicator lists the codes a dataset uses.'}, 'classif2': {'type': 'array', 'items': {'type': 'string', 'maxLength': 64}, 'maxItems': 100, 'description': 'Codes of the second breakdown, for datasets that have one; case-insensitive. ilostat_describe_indicator lists them.'}, 'ref_areas': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Z0-9]{3}$'}, 'maxItems': 300, 'description': 'Reference areas (up to 300): ISO3 country codes (USA) or X-coded aggregates (X01 World); case-insensitive, ILO_GEO_ forms accepted. Aggregates need a dataset with has_aggregates true. Omit for every area.'}, 'time_from': {'type': 'string', 'pattern': '^\\d{4}$', 'description': 'First year (YYYY); upstream filters by year only.'}, 'area_group': {'type': 'string', 'pattern': '^[A-Z0-9]{3}$', 'description': 'X01 for every country, an ILO region or subregion, or a World Bank income group (X06, X56, X02, â\x80¦); expands to its member countries, unioned with ref_areas. ilostat_list_reference topic area_groups lists the codes.'}, 'dataset_ids': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Z0-9_]+$', 'maxLength': 64}, 'maxItems': 3, 'minItems': 1, 'description': 'One to three dataset IDs â\x80\x94 an indicator code plus _A, _Q, or _M (UNE_DEAP_SEX_AGE_RT_A), as ilostat_search_indicators returns them. Case-insensitive; a DF_ prefix (the SDMX dataflow form) is stripped, a bare indicator code resolves when it has one frequency, and an element holding + or , joined IDs is split.'}, 'latest_only': {'type': 'boolean', 'default': False, 'description': 'Only the latest period per reference area and dataset (the latest quarter or month on sub-annual datasets); combines with time_from/time_to.'}, 'source_selection': {'enum': ['best', 'all', 'secondary'], 'type': 'string', 'description': 'best (default): the preferred source per area and period; all: secondary sources too, each row flagged best_source; secondary: secondary sources only. Defaults to all when sources is set.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['datasets', 'row_count', 'rows', 'legend', 'summary', 'attribution', 'applied_filters', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'Inline preview budget, in serialized characters.'}, 'rows': {'type': 'array', 'items': {'type': 'object', 'required': ['dataset_id', 'ref_area', 'source', 'period', 'notes', 'basis'], 'properties': {'sex': {'type': 'string', 'description': 'Sex code; absent when the dataset has no sex breakdown.'}, 'basis': {'enum': ['reported', 'modelled_estimate', 'projection'], 'type': 'string', 'description': 'reported (national or institutional source), modelled_estimate (ILO modelled, up to the cutoff), or projection (ILO modelled, after it).'}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Note codes (legend.notes decodes them).'}, 'value': {'type': 'number', 'description': 'Value in the dataset unit; absent when upstream sent none.'}, 'period': {'type': 'string', 'description': 'Period: YYYY, YYYYQn, or YYYYMmm.'}, 'source': {'type': 'string', 'description': 'Source code (legend.source decodes it).'}, 'classif1': {'type': 'string', 'description': 'First breakdown code, when the dataset has one.'}, 'classif2': {'type': 'string', 'description': 'Second breakdown code, when the dataset has one.'}, 'ref_area': {'type': 'string', 'description': 'Reference area code (legend.ref_area decodes it).'}, 'dataset_id': {'type': 'string', 'description': 'Dataset ID.'}, 'obs_status': {'type': 'string', 'description': 'Observation status flag (legend.obs_status decodes it).'}, 'best_source': {'type': 'boolean', 'description': 'Whether this is the preferred source; set only when secondary sources were requested.'}}, 'description': 'One observation.', 'additionalProperties': False}, 'description': 'Inline preview rows; the staged dataframe holds every row when the result is larger.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['unknown_dataset', 'unknown_code', 'unknown_area_group', 'aggregates_unavailable', 'invalid_period', 'request_too_broad', 'result_too_large', 'dataset_retired', 'upstream_busy', 'catalog_unavailable'], 'description': 'Machine-readable failure mode. Declared by this tool: `unknown_dataset`: A dataset ID is not in the catalog, or a bare indicator code has several frequencies. `unknown_code`: A ref_areas, sex, classif1, classif2, or sources value is not in the ILOSTAT dictionaries. `unknown_area_group`: area_group is not X01, an ILO region or subregion, or a World Bank income group. `aggregates_unavailable`: An X-coded aggregate was requested from a dataset that has no aggregate rows. `invalid_period`: A sub-annual time on a dataset of another frequency, time combined with a range or latest_only, or time_from after time_to. `request_too_broad`: No filters at all and the unfiltered size exceeds the row ceiling. `result_too_large`: The filtered result passed the row ceiling while streaming. `dataset_retired`: Upstream reports a catalog dataset ID as deprecated or invalid. `upstream_busy`: The server-side pacer shed the call, or the ILOSTAT API answered 429 or a challenge page. `catalog_unavailable`: No catalog snapshot has loaded and the load failed, or the first load has not finished within 30 s. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Rows returned inline.'}, 'legend': {'type': 'object', 'required': ['ref_area', 'source', 'sex', 'classif1', 'classif2', 'obs_status', 'notes'], 'properties': {'sex': {'type': 'object', 'description': 'Sex code â\x86\x92 label, for every code in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'notes': {'type': 'object', 'description': 'Note code â\x86\x92 label, for every code in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'source': {'type': 'object', 'description': 'Source code â\x86\x92 label, for every code in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'classif1': {'type': 'object', 'description': 'classif1 code â\x86\x92 label, for every code in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'classif2': {'type': 'object', 'description': 'classif2 code â\x86\x92 label, for every code in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'ref_area': {'type': 'object', 'description': 'Reference area code â\x86\x92 label, for every code in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'obs_status': {'type': 'object', 'description': 'Observation status code â\x86\x92 label, for every code in rows.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}}, 'description': 'Labels for every code in rows.', 'additionalProperties': False}, 'notice': {'type': 'string', 'description': 'Filters that could not narrow a dataset, a unit the structure service could not supply, why nothing matched, where the full result is staged, or why reading stopped early.'}, 'summary': {'type': 'object', 'required': ['ref_areas', 'basis_counts', 'complete'], 'properties': {'complete': {'type': 'boolean', 'description': 'False when reading stopped early, so the counts cover only the rows read.'}, 'ref_areas': {'type': 'number', 'description': 'Distinct reference areas in the rows read.'}, 'period_max': {'type': 'string', 'description': 'Latest period; absent on zero rows.'}, 'period_min': {'type': 'string', 'description': 'Earliest period; absent on zero rows.'}, 'basis_counts': {'type': 'object', 'required': ['reported', 'modelled_estimate', 'projection'], 'properties': {'reported': {'type': 'number', 'description': 'Values from a national or institutional source.'}, 'projection': {'type': 'number', 'description': 'ILO modelled values after the cutoff.'}, 'modelled_estimate': {'type': 'number', 'description': 'ILO modelled estimates up to the cutoff.'}}, 'description': 'Values per basis.', 'additionalProperties': False}}, 'description': 'Summary over every row read, not just the preview.', 'additionalProperties': False}, 'datasets': {'type': 'array', 'items': {'type': 'object', 'required': ['dataset_id', 'label', 'frequency', 'database', 'last_update', 'has_aggregates', 'projection_after_year', 'projection_rule'], 'properties': {'unit': {'type': 'object', 'required': ['measure', 'type', 'multiplier'], 'properties': {'type': {'type': 'string', 'description': 'Unit type code (RT rate, NB number, â\x80¦).'}, 'measure': {'type': 'string', 'description': 'Unit code (PT percent, PS persons, LC local currency, â\x80¦).'}, 'multiplier': {'type': 'number', 'description': 'Power of ten values are expressed in: 0 units, 3 thousands, 6 millions.'}, 'type_label': {'type': 'string', 'description': 'Unit type label.'}, 'measure_label': {'type': 'string', 'description': 'Unit label.'}, 'multiplier_label': {'type': 'string', 'description': 'Multiplier label.'}}, 'description': 'Unit of the values, already in the multiplier scale; absent when unresolved.', 'additionalProperties': False}, 'label': {'type': 'string', 'description': 'Dataset label as ILOSTAT publishes it.'}, 'edition': {'type': 'string', 'description': 'The edition the cutoff derives from, e.g. Nov. 2025.'}, 'database': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'Database code.'}, 'label': {'type': 'string', 'description': 'Database label.'}}, 'description': 'Source database.', 'additionalProperties': False}, 'frequency': {'type': 'string', 'description': 'A (annual), Q (quarterly), or M (monthly).'}, 'dataset_id': {'type': 'string', 'description': 'Dataset ID.'}, 'last_update': {'type': 'string', 'description': 'Last upstream update, ISO 8601 without zone offset.'}, 'has_aggregates': {'type': 'boolean', 'description': 'Whether the dataset carries World, regional, or income-group rows.'}, 'projection_rule': {'enum': ['edition', 'catalog_edition', 'current_year'], 'type': 'string', 'description': "How the cutoff was set: the label's edition, the catalog's latest ILO modelled estimates edition, or the year before the current year."}, 'projection_after_year': {'type': 'number', 'description': 'Last year counted as an estimate; modelled rows after it are classed projection.'}}, 'description': 'One requested dataset and how its values are classed.', 'additionalProperties': False}, 'description': 'The requested datasets, in request order.'}, 'dataframe': {'type': 'object', 'required': ['name', 'row_count', 'expires_at'], 'properties': {'name': {'type': 'string', 'description': 'Staged dataframe name (df_XXXXX_XXXXX) for ilostat_dataframe_query SQL.'}, 'evicted': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Dataframes dropped, oldest first, to keep this tenant within 1,000,000 staged rows and 100 dataframes; present only when staging this one evicted any.'}, 'row_count': {'type': 'number', 'description': 'Rows staged.'}, 'expires_at': {'type': 'string', 'description': 'ISO 8601 expiry of the staged dataframe.'}}, 'description': 'The staged dataframe holding the full result; present only when staged.', 'additionalProperties': False}, 'row_count': {'type': 'number', 'description': 'Rows the request returned â\x80\x94 exact when the result is inline or staged; when reading stopped early (truncated), the rows read.'}, 'truncated': {'type': 'boolean', 'description': 'True when reading stopped at the inline preview and more rows exist.'}, 'attribution': {'type': 'string', 'description': 'Citation to keep with any use of the data.'}, 'applied_filters': {'type': 'object', 'required': ['dataset_ids', 'latest_only', 'source_selection', 'best_source'], 'properties': {'sex': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Sex codes sent.'}, 'time': {'type': 'string', 'description': 'Exact period sent.'}, 'sources': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Source codes sent.'}, 'time_to': {'type': 'string', 'description': 'Last year sent.'}, 'classif1': {'type': 'array', 'items': {'type': 'string'}, 'description': 'classif1 codes sent.'}, 'classif2': {'type': 'array', 'items': {'type': 'string'}, 'description': 'classif2 codes sent.'}, 'ref_areas': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Reference areas given, normalized.'}, 'time_from': {'type': 'string', 'description': 'First year sent.'}, 'area_group': {'type': 'object', 'required': ['code', 'label', 'member_count'], 'properties': {'code': {'type': 'string', 'description': 'Area group code.'}, 'label': {'type': 'string', 'description': 'Area group label.'}, 'member_count': {'type': 'number', 'description': 'Member countries it expanded to.'}}, 'description': 'The area group and how many countries it expanded to.', 'additionalProperties': False}, 'best_source': {'enum': ['yes', 'all', 'no'], 'type': 'string', 'description': 'The upstream best_source value sent.'}, 'dataset_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Datasets requested.'}, 'latest_only': {'type': 'boolean', 'description': 'Whether only the latest period per area was requested.'}, 'ref_area_count': {'type': 'number', 'description': 'Areas sent upstream: ref_areas plus the area_group members.'}, 'source_selection': {'enum': ['best', 'all', 'secondary'], 'type': 'string', 'description': 'Source selection applied (all when sources were given without one).'}}, 'description': 'Every parameter sent upstream, defaults included.', 'additionalProperties': False}}, 'additionalProperties': False}
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Hits per page (1â\x80\x9350).'}, 'query': {'type': 'string', 'maxLength': 500, 'description': 'Plain-language terms, e.g. "youth unemployment" or "informal employment rate". Case, accents, and punctuation are ignored, labor matches labour, and a trailing plural s is tolerated. Omit to browse by filters (results then order by indicator code).'}, 'cursor': {'type': 'string', 'maxLength': 256, 'description': "Opaque continuation token: the previous page's next_cursor, passed unchanged."}, 'subject': {'type': 'string', 'maxLength': 32, 'description': 'Subject code, e.g. LUU (unemployment and labour underutilization); case-insensitive. ilostat_list_reference topic subjects lists them.'}, 'database': {'type': 'string', 'maxLength': 32, 'description': 'Source database code, e.g. LFS or ILOEST (the ILO modelled estimates); case-insensitive. ilostat_list_reference topic databases lists them.'}, 'breakdown': {'type': 'string', 'maxLength': 32, 'description': 'Classification type the indicator is broken down by, e.g. AGE, ECO, GEO, SEX; case-insensitive. ilostat_list_reference topic classification_types lists them.'}, 'frequency': {'enum': ['A', 'Q', 'M'], 'type': 'string', 'description': "Keep only datasets of this frequency: A annual, Q quarterly, M monthly. Narrows each hit's datasets; an indicator with none left drops out."}, 'aggregates_only': {'type': 'boolean', 'default': False, 'description': 'Keep only datasets carrying World, regional, or income-group rows, dropping indicators with none.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['hits', 'total', 'facets', 'catalog_as_of', 'truncated', 'shown', 'cap']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit applied to this page.'}, 'hits': {'type': 'array', 'items': {'type': 'object', 'required': ['indicator', 'label', 'subject', 'database', 'breakdowns', 'has_aggregates', 'datasets'], 'properties': {'label': {'type': 'string', 'description': 'Indicator label as ILOSTAT publishes it.'}, 'subject': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'Subject code.'}, 'label': {'type': 'string', 'description': 'Subject label.'}}, 'description': 'Subject code and label.', 'additionalProperties': False}, 'database': {'type': 'object', 'required': ['code', 'label'], 'properties': {'code': {'type': 'string', 'description': 'Source database code.'}, 'label': {'type': 'string', 'description': 'Source database label.'}}, 'description': 'Source database code and label.', 'additionalProperties': False}, 'datasets': {'type': 'array', 'items': {'type': 'object', 'required': ['dataset_id', 'frequency', 'data_start', 'data_end', 'n_ref_area', 'n_records', 'last_update', 'has_aggregates'], 'properties': {'data_end': {'type': 'number', 'description': 'Last year with data (can include projection years).'}, 'frequency': {'type': 'string', 'description': 'A (annual), Q (quarterly), or M (monthly).'}, 'n_records': {'type': 'number', 'description': 'Observations an unfiltered best-source download returns.'}, 'data_start': {'type': 'number', 'description': 'First year with data.'}, 'dataset_id': {'type': 'string', 'description': 'Dataset ID â\x80\x94 the indicator code plus _A, _Q, or _M â\x80\x94 to pass to ilostat_describe_indicator, ilostat_query_indicator, or ilostat_compare_geographies.'}, 'n_ref_area': {'type': 'number', 'description': 'Reference areas with data.'}, 'last_update': {'type': 'string', 'description': 'Last upstream update, ISO 8601 without zone offset.'}, 'has_aggregates': {'type': 'boolean', 'description': 'Whether this dataset carries World, regional, or income-group rows.'}}, 'description': 'One dataset of the indicator at one frequency.', 'additionalProperties': False}, 'description': 'The datasets that pass the filters, annual first.'}, 'indicator': {'type': 'string', 'description': 'Indicator code (dataset IDs add _A, _Q, or _M).'}, 'breakdowns': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Breakdown names (e.g. ["sex", "age"]); empty when none.'}, 'match_scope': {'enum': ['label', 'metadata', 'definition'], 'type': 'string', 'description': 'Where every term matched: label (tier 1), label plus subject, database, breakdowns, and code (tier 2), or the definition text too (tier 3). Absent when browsing without a query.'}, 'classification': {'type': 'string', 'description': 'Breakdown classification (e.g. SEX_AGE); absent when the indicator has none.'}, 'has_aggregates': {'type': 'boolean', 'description': 'Whether any listed dataset carries World, regional, or income-group rows.'}}, 'description': 'One indicator hit.', 'additionalProperties': False}, 'description': 'This page of hits. With a query: tier, then more reference areas first, then code. Without: by code.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['unknown_filter_code', 'invalid_cursor', 'catalog_unavailable'], 'description': 'Machine-readable failure mode. Declared by this tool: `unknown_filter_code`: database, subject, or breakdown is not an ILOSTAT code. `invalid_cursor`: cursor does not decode. `catalog_unavailable`: No catalog snapshot has loaded and the load failed, or the first load has not finished within 30 s. Other values are possible when a failure originates below the handler.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Hits returned on this page.'}, 'total': {'type': 'number', 'description': 'Indicators matched after all filters.'}, 'facets': {'type': 'object', 'required': ['databases', 'frequencies', 'subjects'], 'properties': {'subjects': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'label', 'count'], 'properties': {'code': {'type': 'string', 'description': 'Facet code.'}, 'count': {'type': 'number', 'description': 'Matching indicators with this value.'}, 'label': {'type': 'string', 'description': 'Facet label.'}}, 'description': 'One facet value and its indicator count.', 'additionalProperties': False}, 'description': 'Matching indicators per subject.'}, 'databases': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'label', 'count'], 'properties': {'code': {'type': 'string', 'description': 'Facet code.'}, 'count': {'type': 'number', 'description': 'Matching indicators with this value.'}, 'label': {'type': 'string', 'description': 'Facet label.'}}, 'description': 'One facet value and its indicator count.', 'additionalProperties': False}, 'description': 'Matching indicators per source database.'}, 'frequencies': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'count'], 'properties': {'code': {'type': 'string', 'description': 'Frequency code (A, Q, M).'}, 'count': {'type': 'number', 'description': 'Matching indicators with a dataset at this frequency.'}}, 'description': 'One frequency and its indicator count.', 'additionalProperties': False}, 'description': 'Matching indicators per frequency.'}}, 'description': 'Counts over the fully filtered match set, not just this page.', 'additionalProperties': False}, 'notice': {'type': 'string', 'description': 'Why the query was browsed by filters alone, how to widen a search that matched nothing, that the cursor starts past the last match, and how to reach the remaining pages â\x80\x94 whichever apply, joined.'}, 'truncated': {'type': 'boolean', 'description': 'True when more hits remain beyond this page.'}, 'next_cursor': {'type': 'string', 'description': 'Pass as cursor to get the next page; absent on the last page.'}, 'catalog_as_of': {'type': 'string', 'description': 'ISO timestamp the searched catalog was last confirmed current.'}}, 'additionalProperties': False}
Letzte Tool-Änderungen
Ähnliche MCP-Server
LiveDataLink
Exposes public-data tools covering economics, labor, banking, transport, books, legal opinions, carriers, environmental data, and…
AlpineDataWorks Intelligence Server
Provides economic, market, supply-chain, real-estate, energy, consumer, labor, and other scored intelligence indices with histori…
SharksAPI.AI
Provides marketing analytics and actions across GA4, Search Console, Google Ads, social channels, SEO, WordPress, and marketing p…
synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…