# AptiBuild AI — Bulk Occupations Data

> AptiBuild AI — Bulk Occupations Data is a paid API for AI agents from data.aptibuildai.com, paid per call via x402, $15/call, status unknown (last checked 2026-09-13).

Returns bulk U.S. occupation data from the SOC classification system, optionally filtered by state or major occupational group.

## Facts

- Endpoint: GET https://data.aptibuildai.com/data/bulk/occupations
- Price: $15/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-bulk-occupations-data-b5282340
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PfoJU8FKBzN3mM33EPaKJ

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-bulk-occupations-data-b5282340
```

Example prompt: Can you pull all healthcare occupations (SOC major group 29) in California from the AptiBuild AI occupations dataset?

## When to prefer this

Choose this endpoint when you need structured, bulk U.S. occupational data organized by SOC codes and optionally scoped to a specific state. It is well-suited for labor market research, workforce planning tools, or any application that needs to enumerate occupations by category. Prefer this over general web scraping or BLS lookups when you need a pre-aggregated, machine-readable snapshot with snapshot dating.

## Known failure modes

- Invalid state name returns empty or error result
- Unknown SOC major group prefix returns zero results
- Payment failure (402) if USDC payment is not properly attached
- Network timeout on large unfiltered national dataset requests
- Malformed query parameters may return unexpected full dataset

## 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 count of matching occupations, the data source identifier, a snapshot date string, and an array of occupation objects conforming to SOC classifications. When filters are applied, only matching records are returned; without filters, the full national dataset is returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "state": {
   "type": "string",
   "description": "Optional: filter by state name (e.g. 'Texas'). Omit for national data."
  },
  "major_group": {
   "type": "string",
   "description": "Optional: filter by SOC major group code prefix (e.g. '15' for Computer occupations, '29' for Healthcare). Omit for full dataset."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "integer"
  },
  "source": {
   "type": "string"
  },
  "occupations": {
   "type": "array",
   "items": {
    "type": "object"
   }
  },
  "snapshot_date": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aptibuild-ai-bulk-occupations-data-b5282340/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)