# SYNTHORA US Unemployment Rate (BLS Public API)

> SYNTHORA US Unemployment Rate (BLS Public API) is a paid API for AI agents from bls-unemployment-rate-us.hergertsynthora.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Fetches the official US national unemployment rate (BLS series LNS14000000) for a specified date range, returning monthly values via the BLS Public Data API.

## Facts

- Endpoint: POST https://bls-unemployment-rate-us.hergertsynthora.com/service
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/synthora-us-unemployment-rate-bls-public-api-0376cf34
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fnkPVhbgBCgVKaN3YC5Lq

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 synthora-us-unemployment-rate-bls-public-api-0376cf34 -d '<json body>'
```

Example prompt: Can you pull the official US unemployment rate from BLS for each month between 2020 and 2025 so I can see how joblessness trended over that period?

## When to prefer this

Choose this endpoint when you need the official US national unemployment rate from the BLS (series LNS14000000), especially for autonomous macro pipelines, recession-signal models, or agent-to-agent workflows that require authoritative government labor statistics without managing BLS API keys or rate limits directly.

## Known failure modes

- Invalid or missing year range returns an error or empty data
- BLS API rate limits or downtime may cause upstream fetch failures
- Requesting future years beyond available BLS data returns no results
- Malformed seriesid array may cause a 400-level error

## How this service works

US national unemployment rate (series LNS14000000) monthly values from the keyless BLS Public Data API via POST JSON. Serves autonomous labor-market agents, recession-signal models, and agent-to-agent macro pipelines tracking the official US jobless rate. First 3 calls FREE per wallet — send header X-WALLET: 0x<addr>. No charge on upstream failure.

## Output

Returns a JSON object with ok status, the BLS series ID (LNS14000000), the latest unemployment rate value, the latest date and period name (e.g. 'December'), and provenance metadata pointing back to the BLS Public API.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "endyear": {
   "type": "string",
   "description": "endyear"
  },
  "seriesid": {
   "type": "array",
   "description": "seriesid"
  },
  "startyear": {
   "type": "string",
   "description": "startyear"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "bls-unemployment-rate-us",
  "result": {
   "footnotes": [],
   "series_id": "LNS14000000",
   "latest_date": "2025-December",
   "latest_year": "2025",
   "latest_value": "4.4",
   "latest_period": "M12",
   "latest_period_name": "December"
  },
  "provenance": {
   "url": "https://api.bls.gov/publicAPI/v2/timeseries/data/",
   "source": "US Unemployment Rate (BLS Public API)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/synthora-us-unemployment-rate-bls-public-api-0376cf34/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bls-unemployment-rate-us.hergertsynthora.com](https://www.zero.xyz/host/bls-unemployment-rate-us.hergertsynthora.com/llms.txt)