Compare countries

~3 credits / comparison (up to 6)

Retrieves the same economic or demographic indicator for multiple countries at once, making direct comparisons possible. Returns each country's value for the chosen metric and year, using identical units across all entries so the comparison is apples to apples.

Use when

You want to rank or compare countries on the same economic or demographic metric.

Not for

A single country's series, or US sub-national figures.

Cost

~3 credits / comparison (up to 6)

A handful of countries on one recent value is the usual case; many countries over many years returns more rows.

Estimated; the actual charge depends on your input and is shown in the response.

What it accepts

Set these inside the intent when you run it.

metricrequired

The economic or demographic figure to compare across countries.

countriesrequired

Two or more country names to compare on the same metric.

periodoptional

A single year, a year range, or "latest". Defaults to the most recent available value.

What you get back

A side-by-side table of indicator values, one row per country, with the year and units.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Economic & Demographic Data skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/economic-data/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"compare_countries","metric":"unemployment rate","countries":"France, Italy, Spain","period":2022}}'

Example requests

  • Compare GDP per capita across the G7 countries.
  • Which country has the highest life expectancy: Japan, Germany, or the US?
  • Rank China, India, and Brazil by their 2022 inflation rate.