# AptiBuild AI — BLS Occupation Wages Lookup

> AptiBuild AI — BLS Occupation Wages Lookup is a paid API for AI agents from data.aptibuildai.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Returns BLS wage data (hourly and annual, median and percentile breakdowns) for a given SOC occupation code, optionally filtered by state

## Facts

- Endpoint: GET https://data.aptibuildai.com/data/occupations/wages
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aptibuild-ai-bls-occupation-wages-lookup-9511dae3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6CMdMV6oBgPBMDihiLEvz

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 aptibuild-ai-bls-occupation-wages-lookup-9511dae3
```

Example prompt: What are the annual median and 75th percentile wages for software developers — BLS occupation code 15-1252 — in Texas?

## When to prefer this

Use this endpoint when you need structured BLS wage data tied to a specific SOC occupation code, especially when you want percentile breakdowns (10th, 25th, 75th, 90th) at both hourly and annual granularity. It is ideal for salary benchmarking, career research, workforce analytics, or building compensation-aware applications. Prefer this over generic web search when you need machine-readable, structured wage data with consistent schema. The optional state filter makes it useful for geographic wage comparisons.

## Known failure modes

- Missing or invalid occ_code parameter returns an error — the SOC code is required and must be a valid BLS format (e.g. '15-1252')
- Non-existent or misspelled state name may return zero results rather than an error
- SOC codes with no BLS wage data on record return an empty wages array with count 0
- Malformed SOC code format (e.g. missing hyphen) may cause a lookup failure
- Payment failure (402) if the x402 payment is not completed before the request

## How this service works

Discover what to build based on your unique skills and hobbies. AptiBuild AI generates personalized app and business ideas matched to your experience. Free to try.

## Output

Returns a JSON object containing a wages array where each entry includes the occupation code, occupation title, annual and hourly wages at the 10th, 25th, 75th, and 90th percentiles, as well as annual and hourly median wages. Also includes the total count of matching records, the original query parameters echoed back, and a source attribution string indicating the BLS data origin.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "occ_code"
 ],
 "properties": {
  "state": {
   "type": "string",
   "description": "Optional state name filter"
  },
  "occ_code": {
   "type": "string",
   "description": "BLS SOC occupation code (e.g. '29-1141' for Registered Nurses, '15-1252' for Software Developers)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "integer"
  },
  "query": {
   "type": "object"
  },
  "wages": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "a_pct10": {
      "type": "string"
     },
     "a_pct25": {
      "type": "string"
     },
     "a_pct75": {
      "type": "string"
     },
     "a_pct90": {
      "type": "string"
     },
     "h_pct10": {
      "type": "string"
     },
     "h_pct25": {
      "type": "string"
     },
     "h_pct75": {
      "type": "string"
     },
     "h_pct90": {
      "type": "string"
     },
     "a_median": {
      "type": "string"
     },
     "h_median": {
      "type": "string"
     },
     "occ_code": {
      "type": "string"
     },
     "occ_title": {
      "type": "string"
     }
    }
   }
  },
  "source": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aptibuild-ai-bls-occupation-wages-lookup-9511dae3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.aptibuildai.com](https://www.zero.xyz/host/data.aptibuildai.com/llms.txt)