Economics

Data source: ILO (SDMX 2.1)

REST Bridge Endpoint https://context.gnist.ai/rest/ilostat/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (6)

search_datasets
list_datasets
get_dataset_structure
get_data
compare_countries
report_feedback

search_datasets

Search the ILOSTAT dataset catalog by keyword.

Returns matching datasets with their dataflow IDs needed for
get_data, get_dataset_structure, and compare_countries calls.
ILOSTAT covers employment, unemployment, wages, working conditions,
labour force participation, child labour, migration, and social
protection across 190+ countries.

Args:
query: Search term (e.g. "unemployment", "wages", "child labour").
limit: Number of results to return (1-50, default 20).

Returns:
List of matching datasets with id, name, agency, and description.
Use the 'id' field as the dataflow parameter in other tools.

Parameter	Type	Required	Description
`query`	`string`	required	Search term for ILOSTAT datasets (e.g. "unemployment", "wages", "child labour", "migration", "working poverty").
`limit`	`integer`	optional	Number of results to return (1-50, default 20). (default: 20)

Request Body

{
  "query": "example"
}

list_datasets

List available ILOSTAT datasets, optionally filtered by topic.

Browse the full ILOSTAT data catalog. Use this to discover what
datasets exist before querying specific data.

Args:
topic: Optional topic filter keyword. Omit to list all datasets.
limit: Maximum datasets to return (1-100, default 50).

Returns:
List of datasets with id, name, and description.

Parameter	Type	Required	Description
`topic`	`any`	optional	Optional topic filter (e.g. "employment", "wages", "labour force", "migration"). Omit to list all.
`limit`	`integer`	optional	Maximum datasets to return (1-100, default 50). (default: 50)

Request Body

{
  "query": "example"
}

get_dataset_structure

Get the dimension structure of an ILOSTAT dataset.

Shows what dimensions (filters) are available for a dataset and their
valid values. Use this before get_data to understand what country codes,
sex breakdowns, age groups, and other parameters are accepted.

Args:
dataflow: ILOSTAT dataflow identifier from search_datasets.

Returns:
List of dimensions with their valid codes/values. Each dimension
shows its position in the SDMX key and sample values.

Parameter	Type	Required	Description
`dataflow`	`string`	required	ILOSTAT dataflow identifier from search_datasets (e.g. "DF_UNE_2EAP_SEX_AGE_RT", "DF_EMP_TEMP_SEX_AGE_NB").

Request Body

{
  "dataflow": "example"
}

get_data

Fetch data from an ILOSTAT dataset.

Query any ILOSTAT dataset by country and time period. Covers
employment, unemployment, wages, working conditions, labour force
participation, child labour, migration, and social protection
across 190+ countries worldwide.

Args:
dataflow: ILOSTAT dataflow identifier. Use search_datasets to find IDs.
countries: ISO alpha-2/3 country codes. Omit for all countries.
start_period: Start period filter (e.g. "2015").
end_period: End period filter (e.g. "2023").
dimension_filter: Advanced SDMX dimension key. Overrides countries.
limit: Maximum observations to return (1-1000, default 200).

Returns:
Observations with all dimension labels and values.

Parameter	Type	Required	Description
`dataflow`	`string`	required	ILOSTAT dataflow identifier (e.g. "DF_UNE_2EAP_SEX_AGE_RT"). Use search_datasets to find IDs.
`countries`	`any`	optional	ISO alpha-2/3 country codes (e.g. ["USA", "DEU", "NOR"]). Omit for all countries.
`start_period`	`any`	optional	Start period (e.g. "2015", "2020-Q1", "2020-01").
`end_period`	`any`	optional	End period (e.g. "2023", "2023-Q4", "2023-12").
`dimension_filter`	`any`	optional	Advanced: SDMX dimension key filter (dot-separated, e.g. "USA.A.UNE_DEAP_RT.SEX_T.YGE15"). Overrides countries param. Use get_dataset_structure to find valid dimension values.
`limit`	`integer`	optional	Maximum observations to return (1-1000, default 200). (default: 200)

Request Body

{
  "dataflow": "example"
}

compare_countries

Compare data across countries for a given ILOSTAT dataset.

Fetches the same indicator for multiple countries side by side.
Useful for cross-country analysis of unemployment rates, wage levels,
labour force participation, and other ILO labour statistics.

Args:
dataflow: ILOSTAT dataflow identifier.
country_codes: ISO alpha-2/3 country codes to compare. Maximum 20.
start_period: Start period. Omit for most recent data.
end_period: End period. Omit for most recent data.

Returns:
Data grouped by country for easy comparison.

Parameter	Type	Required	Description
`dataflow`	`string`	required	ILOSTAT dataflow identifier (e.g. "DF_UNE_2EAP_SEX_AGE_RT").
`country_codes`	`list[string]`	required	ISO alpha-2/3 country codes to compare (e.g. ["USA", "DEU", "JPN", "NOR"]). Maximum 20.
`start_period`	`any`	optional	Start period (e.g. "2020"). Omit for most recent data.
`end_period`	`any`	optional	End period (e.g. "2023"). Omit for most recent data.

Request Body

{
  "dataflow": "example",
  "country_codes": [
    "example"
  ]
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/ilostat/search_datasets" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"query": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/ilostat/search_datasets",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())