# SOC 2018 Occupation Code Search

> SOC 2018 Occupation Code Search is a paid API for AI agents from industry-occupation-codes.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Search Standard Occupational Classification (SOC) 2018 occupations by keyword or code prefix, with optional level filtering, returning up to 50 matches.

## Facts

- Endpoint: GET https://industry-occupation-codes.x402tookit.com/soc-search?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/soc-2018-occupation-code-search-d1a7fa73
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ri7Uc0UcJzATriLO1i15B

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 soc-2018-occupation-code-search-d1a7fa73
```

Example prompt: Can you search the SOC 2018 occupation codes for anything related to 'software developer' and give me up to 20 results, only at the detailed occupation level (level 4)?

## When to prefer this

Use this endpoint when you need to find or validate SOC 2018 Standard Occupational Classification codes by keyword search or code prefix. It is specifically suited for fuzzy title-based discovery (e.g. entering 'nurse' to find all nursing occupations) or prefix-based browsing of the SOC hierarchy. Prefer it over the SOC code-to-detail endpoint when you don't already know the exact code, and over the SOC child-listing endpoint when you want keyword matching rather than hierarchical traversal.

## Known failure modes

- No matches found for the query term — returns empty matches array
- Query parameter 'q' missing — returns 400 or validation error
- Limit set above 50 — capped or rejected
- Invalid level value (outside 1–4) — returns validation error or unfiltered results
- Service degraded — degraded flag set true with partial or no results

## How this service works

Search SOC 2018 occupations by words in the title or a code prefix; optional level filter; capped at 50.

## Output

Returns a list of matching SOC 2018 occupation entries, each with a code (e.g. '15-1252'), title, numeric level (1–4), level name (e.g. 'Detailed Occupation'), and a match score. Also includes total match count, whether results were truncated, the echoed query parameters, data source attribution, and an as-of date.

## 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",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Words like 'registered nurse' or 'software', or a code prefix like 15-12"
      },
      "level": {
       "type": "integer",
       "description": "1 major group, 2 minor group, 3 broad occupation, 4 detailed occupation"
      },
      "limit": {
       "type": "integer",
       "description": "Results 1 to 50 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "query": {
       "type": [
        "null",
        "object"
       ],
       "properties": {
        "q": {
         "type": [
          "null",
          "string"
         ]
        },
        "level": {
         "type": [
          "null",
          "number"
         ]
        }
       }
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "matches": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "code": {
          "type": [
           "null",
           "string"
          ]
         },
         "level": {
          "type": [
           "null",
           "number"
          ]
         },
         "title": {
          "type": [
           "null",
           "string"
          ]
         },
         "levelName": {
          "type": [
           "null",
           "string"
          ]
         },
         "matchScore": {
          "type": [
           "null",
           "number"
          ]
         }
        }
       }
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ]
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": 
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/soc-2018-occupation-code-search-d1a7fa73/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from industry-occupation-codes.x402tookit.com](https://www.zero.xyz/host/industry-occupation-codes.x402tookit.com/llms.txt)