# Unemployment Rate by Country (World Bank)

> Unemployment Rate by Country (World Bank) is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Returns total and youth unemployment rates as % of labour force for any country, sourced from World Bank/ILO modelled estimates, for up to 10 years of history.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/econ/unemployment?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agent-data-tools.revmesh2074.workers.dev
- Website: https://agent-data-tools.revmesh2074.workers.dev
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-unemployment-rate-by-country-24e20b1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8_nrZJMEpgl6wkwXvI91z

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent-data-tools-revmesh2074-workers-dev-unemployment-rate-by-country-24e20b1f
```

Example prompt: What are the total and youth unemployment rates for Spain over the last 5 years, based on World Bank data?

## When to prefer this

Choose this endpoint when you need structured, time-series unemployment data (total and/or youth) for any country from a reliable, citable source (World Bank/ILO). It is preferable to web scraping or news sources because it returns machine-readable JSON from a committed data snapshot with a known license (CC BY 4.0). It covers both total and youth unemployment in one call, making it ideal for macro research, dashboards, and labour market analysis without needing a World Bank API key.

## Known failure modes

- Unrecognised country code or name returns an error — use ISO 3166 alpha-2/alpha-3 or standard English country name
- Data unavailable for very recent years (ILO estimates lag by 1-2 years) — latest available year may not be the current calendar year
- years parameter outside 1-10 range may be rejected or clamped
- Small or disputed territories may not have World Bank data

## How this service works

Unemployment rate of any country from World Bank data (ILO modelled estimates): total unemployment and youth unemployment (ages 15-24) as % of the labour force, for the last 1-10 years with the newest year first. Country by ISO code (SE, SWE) or English name. Read from a committed World Bank Open Data snapshot (CC BY 4.0), so every call answers at once; the snapshot date is in the answer. Use for labour-market and macro questions.

## Output

A JSON object containing country metadata (name, ISO codes, region, capital, income level), total unemployment time series (latest year value plus array of year/value pairs), and youth unemployment time series (ages 15-24), all labelled with World Bank indicator codes and a snapshot date indicating data vintage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "country"
 ],
 "properties": {
  "years": {
   "type": "integer",
   "description": "Years of history to return, 1-10 (default 5)"
  },
  "country": {
   "type": "string",
   "description": "ISO 3166 code (SE, SWE) or English country name (Sweden)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "source": {
   "type": "string"
  },
  "country": {
   "type": "object",
   "properties": {
    "code": {
     "type": "string"
    },
    "iso2": {
     "type": "string"
    },
    "name": {
     "type": "string"
    },
    "region": {
     "type": "string"
    },
    "capital": {
     "type": "string"
    },
    "incomeLevel": {
     "type": "string"
    }
   }
  },
  "unemployment": {
   "type": "object",
   "properties": {
    "latest": {
     "type": "object",
     "properties": {
      "year": {
       "type": "number"
      },
      "value": {
       "type": "number"
      }
     }
    },
    "values": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "year": {
        "type": "number"
       },
       "value": {
        "type": "number"
       }
      }
     }
    },
    "indicator": {
     "type": "string"
    }
   }
  },
  "youthUnemployment": {
   "type": "object",
   "properties": {
    "latest": {
     "type": "object",
     "properties": {
      "year": {
       "type": "number"
      },
      "value": {
       "type": "number"
      }
     }
    },
    "values": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "year": {
        "type": "number"
       },
       "value": {
        "type": "number"
       }
      }
     }
    },
    "indicator": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-unemployment-rate-by-country-24e20b1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)