# HealthParse Wage Benchmarks API

> HealthParse Wage Benchmarks API is a paid API for AI agents from api.healthparse.io, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns BLS OEWS-sourced healthcare wage statistics (median, mean, P25–P90 percentiles, employment) by SOC occupation code and geographic area (national, state, or metro).

## Facts

- Endpoint: GET https://api.healthparse.io/v1/wages/search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/healthparse-wage-benchmarks-api-0280e506
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6wkmpyCZXNm7OpQw-9yPc

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 healthparse-wage-benchmarks-api-0280e506
```

Example prompt: What does a registered nurse (SOC code 29-1141) earn in California — give me the median, mean, and P25 through P90 wage percentiles for the most recent year available.

## When to prefer this

Use this endpoint when you need BLS OEWS wage statistics for healthcare occupations broken down by geography (national, state, or metro area), including full percentile distributions (P25–P90). Prefer this over generic HR salary tools when you need authoritative government labor statistics with employment counts, or when benchmarking compensation for a specific SOC-coded role in a specific market.

## Known failure modes

- Invalid SOC occupation code returns empty results or 400 error
- Unrecognized area code or area type returns no matches
- Requested year not available in BLS dataset returns empty or error
- Exceeding limit maximum of 100 returns validation error
- Missing required filters may return overly broad or paginated results requiring offset navigation

## How this service works

Healthcare wage benchmarks by SOC occupation and area (national, state, metro): median, mean, and P25–P90 percentiles plus employment. Answers: what does this role pay in this market? Source: BLS OEWS.

## Output

Returns a list of wage records for the matched occupation and geography, each containing median wage, mean wage, P25/P50/P75/P90 wage percentiles, and total employment count, sourced from BLS OEWS data for the requested year.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "year": {
     "type": "integer"
    },
    "limit": {
     "type": "integer",
     "default": 25,
     "maximum": 100
    },
    "state": {
     "type": "string"
    },
    "offset": {
     "type": "integer",
     "default": 0
    },
    "area_code": {
     "type": "string"
    },
    "area_type": {
     "type": "string"
    },
    "occupation_code": {
     "type": "string"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthparse-wage-benchmarks-api-0280e506/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.healthparse.io](https://www.zero.xyz/host/api.healthparse.io/llms.txt)