get_time_series
Retrieve the complete time series for a UNESCO UIS indicator by country or region. Filter by year range to analyze trends and visualize data changes over time.
Instructions
Get the full time series for a UNESCO UIS indicator for one country or region.
Returns all data points for the indicator × geography combination, optionally filtered to a year range. Ideal for trend analysis and time-series visualisation.
GEOGRAPHY RULES:
For countries: pass the ISO3 code directly (e.g. "KEN", "FRA").
For regions: ALWAYS call search_geo_units first — it will ask the user which grouping system to use. Regional names map to multiple codes with different country compositions; using the wrong one gives silently wrong data.
If omitted, the tool will interactively ask the user for the geography.
Args: indicator_code: The indicator code (e.g. "LR.AG15T99"). geo_unit_code: ISO3 code for countries, or a confirmed code from search_geo_units for regions. Omit to trigger interactive geography lookup. start_year: Optional. First year to include (inclusive). end_year: Optional. Last year to include (inclusive).
Returns: A dictionary with: - "indicator_code", "indicator_name": Indicator identity. - "geo_unit_code", "geo_unit_name": Geography identity. - "data_points": Chronological list of {year, value, qualifier}. - "summary": {total_data_points, min_value, max_value, latest_year, note}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| indicator_code | Yes | ||
| geo_unit_code | No | ||
| start_year | No | ||
| end_year | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||