# Economic & Demographic Data

> Skill `economic-data` on Faro. 5 sub-skills.

Retrieves macroeconomic indicators and country economic data: GDP, inflation, unemployment rates, interest rates, and more. Covers historical time series and current values across countries and US sub-national geographies. Replaces approximate recalled statistics with exact published figures from official sources.

**Category:** Finance & Markets  
**Tags:** economics, demographics, indicators, census, development  
**Use when:** You need a precise economic or population statistic for a country or US geography instead of an approximate recalled number.  
**Not for:** Live market prices, company financials, forecasts or projections, and statistics for places or years the official sources do not cover.  
**Returns:** information — Returns the exact values with the place, year, indicator name, and units, plus the source attribution and the date the data was last updated. Values can be missing for some years; those are flagged, not reported as zero. Not a downloadable file.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/economic-data/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"What was India's GDP in 2023?"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run economic-data "What was India's GDP in 2023?"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- What was India's GDP in 2023?
- Compare GDP per capita across the G7 countries.
- What indicator code covers consumer price inflation?
- What is the code for South Korea?

## Sub-skills

### Get an indicator

Returns an economic or demographic indicator for one country over time.

**Cost:** ~2 credits / lookup (up to 5) — A single current value is the usual case; a long year range over many countries returns more rows.

**Use when:** You want a specific country's value for a metric like GDP, population, or inflation.

**Details:** https://askfaro.com/llms/skills/economic-data/fetch_indicator.md

---

### Compare countries

Returns one indicator side by side for several countries.

**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.

**Use when:** You want to rank or compare countries on the same economic or demographic metric.

**Details:** https://askfaro.com/llms/skills/economic-data/compare_countries.md

---

### Find an indicator

Finds the indicator code that best matches a metric described in words.

**Cost:** ~2 credits / lookup (up to 4) — A keyword search returns a short list of candidate codes; a broad browse returns more.

**Use when:** You know the metric you want but not which code to query, or want to browse available series.

**Details:** https://askfaro.com/llms/skills/economic-data/find_indicator.md

---

### Resolve a country code

Resolves a country name to the code its data is keyed by, with its region and income level.

**Cost:** ~2 credits / lookup (up to 4) — Resolving one country is the usual case; listing all countries returns the full set.

**Use when:** You need a country's code, or want to group or list countries by region or income level.

**Details:** https://askfaro.com/llms/skills/economic-data/resolve_country.md

---

### US Census data

Returns US demographic figures (population, income, housing) for a state, county, or tract.

**Cost:** ~2 credits / query (up to 6) — A few variables for a set of geographies is the usual case; every county or tract returns more rows.

**Use when:** You need official US sub-national figures by geography from a Census survey.

**Details:** https://askfaro.com/llms/skills/economic-data/census_query.md

---

---
On the web: https://askfaro.com/search/economic-data