EconDash

Searches the EconDash catalogue of economic, financial, demographic and social indicators by keyword. Returns up to 25 matches with the slug, name, unit, frequency, source and years covered. The slug is the input for get_indicator_series, compare_countries and get_indicator_details.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Words to search for, for example 'inflation' or 'gdp per capita'.",
      "maxLength": 100,
      "minLength": 2,
      "title": "Query",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of results.",
      "maximum": 25,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_indicatorsArguments"
}

Returns values of one indicator for one country or region. A call returns at most 30 annual, 40 quarterly, 120 monthly, 52 weekly, 250 daily values (about 30 years of annual data, 10 years of quarterly or monthly, one year of weekly or daily). Without years: the latest observed values. With start_year and/or end_year: the values in that range; when the range holds more, the latest ones are returned and truncated is true. With year: one value for that year (the last period of that year for monthly or quarterly data). Includes the unit, source, licence, the range of periods with data and a link to the EconDash chart page that shows the full history. Projections such as IMF forecasts are labelled; without end_year or year, the series stops at the latest observed value and the nearest projection comes in a separate next_projection field. Country is an ISO 3166-1 alpha-3 code.

{
  "type": "object",
  "properties": {
    "indicator": {
      "description": "Indicator slug from search_indicators, for example cpi-inflation.",
      "maxLength": 255,
      "minLength": 1,
      "pattern": "^[a-z0-9_-]+$",
      "title": "Indicator",
      "type": "string"
    },
    "country": {
      "description": "ISO 3166-1 alpha-3 code, for example USA, DEU, ARG, or WLD for the world.",
      "pattern": "^[A-Za-z]{3}$",
      "title": "Country",
      "type": "string"
    },
    "year": {
      "anyOf": [
        {
          "maximum": 2100,
          "minimum": 1800,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Calendar year for a single value. Omit to get a series.",
      "title": "Year"
    },
    "start_year": {
      "anyOf": [
        {
          "maximum": 2100,
          "minimum": 1800,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "First calendar year of the series.",
      "title": "Start Year"
    },
    "end_year": {
      "anyOf": [
        {
          "maximum": 2100,
          "minimum": 1800,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Last calendar year of the series; projections up to this year are included.",
      "title": "End Year"
    }
  },
  "required": [
    "indicator",
    "country"
  ],
  "title": "get_indicator_seriesArguments"
}

Returns one value of one indicator for up to 20 countries or regions: for the given year, or the latest observed value in each country when no year is given. Each value has its own period and chart link; projections are labelled. Codes without data are listed separately.

{
  "type": "object",
  "properties": {
    "indicator": {
      "description": "Indicator slug from search_indicators, for example cpi-inflation.",
      "maxLength": 255,
      "minLength": 1,
      "pattern": "^[a-z0-9_-]+$",
      "title": "Indicator",
      "type": "string"
    },
    "countries": {
      "description": "ISO3 codes of the countries or regions to compare.",
      "items": {
        "description": "ISO 3166-1 alpha-3 code, for example USA, DEU, ARG, or WLD for the world.",
        "pattern": "^[A-Za-z]{3}$",
        "type": "string"
      },
      "maxItems": 20,
      "minItems": 1,
      "title": "Countries",
      "type": "array"
    },
    "year": {
      "anyOf": [
        {
          "maximum": 2100,
          "minimum": 1800,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Calendar year. Omit for the latest observed value.",
      "title": "Year"
    }
  },
  "required": [
    "indicator",
    "countries"
  ],
  "title": "compare_countriesArguments"
}

Returns the description, unit, frequency, source, publisher, licence, attribution text, coverage in years and countries, and the time of the last data change for one indicator.

{
  "type": "object",
  "properties": {
    "indicator": {
      "description": "Indicator slug from search_indicators, for example cpi-inflation.",
      "maxLength": 255,
      "minLength": 1,
      "pattern": "^[a-z0-9_-]+$",
      "title": "Indicator",
      "type": "string"
    }
  },
  "required": [
    "indicator"
  ],
  "title": "get_indicator_detailsArguments"
}

Lists the countries and regional aggregates in EconDash as ISO 3166-1 alpha-3 codes with names. Regions include World Bank groups such as WLD (World) and EUU (European Union).

{
  "type": "object",
  "properties": {},
  "title": "list_countriesArguments"
}