# Citiview BLS Wage Data Lookup

> Citiview BLS Wage Data Lookup is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-15).

Returns BLS occupational wage survey data for any job title or SOC code, including employment count, mean/median pay, and percentile pay ranges, nationally or by US state.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/wages?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-bls-wage-data-lookup-dfe96378
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DKt91LivQYUmlLYXEZMYc

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 citiview-bls-wage-data-lookup-dfe96378
```

Example prompt: What does the BLS say about salaries for data scientists in California — I need the mean, median, and 10th to 90th percentile annual pay figures.

## When to prefer this

Use this endpoint when you need authoritative, government-sourced wage and employment data tied to official BLS occupational classifications. Prefer it over scraped or crowdsourced salary sites (e.g. Glassdoor, Payscale) when accuracy and official sourcing matter, such as for HR compensation planning, policy research, or career counseling. It is especially useful when you need percentile breakdowns (not just averages) or state-level granularity.

## Known failure modes

- Job title cannot be matched to a SOC code — returns an error or empty result
- SOC code provided does not exist in BLS data — returns not found
- State name or code not recognized — may return national data or error
- BLS data unavailable for a given occupation/state combination (suppressed due to small sample) — returns no data
- Invalid query parameters — returns 400-level error

## How this service works

Salary data for any job title: employment, mean and median annual and hourly pay, and 10th to 90th percentile annual pay, nationally and for a US state, from the BLS occupational wage survey. Job titles are matched to SOC codes automatically.

## Output

Returns structured BLS occupational wage survey data including: the matched SOC code and occupation title, total employment, mean and median annual salary, mean and median hourly wage, and annual pay at the 10th, 25th, 75th, and 90th percentiles — either nationally or filtered to a specific US state.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "soc": {
       "type": "string",
       "description": "6-digit SOC code instead, e.g. 15-1252"
      },
      "state": {
       "type": "string",
       "description": "State name or code"
      },
      "occupation": {
       "type": "string",
       "description": "Job title"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-bls-wage-data-lookup-dfe96378/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)
