# SOC 2018 — AutoSugges platform dataset

## How do I add SOC 2018 autocomplete to my app?

SOC 2018 is a free AutoSugges reference list of 1,447 items. Query it with your publishable key as the key parameter and the typed text as q, after at least two characters. Results come back pre-ranked from the edge, ten by default, ready for the AutoSugges React, React Native or HTML component.

The 2018 Standard Occupational Classification: 1,447 occupation codes across four levels, searchable by code or by title. Published by the U.S. Bureau of Labor Statistics.

1447 items, across levels: major_group, minor_group, broad_occupation, detailed_occupation.
Level breakdown: major_group: 23, minor_group: 98, broad_occupation: 459, detailed_occupation: 867.

## Provenance
Source: U.S. Bureau of Labor Statistics (https://www.bls.gov/soc/2018/soc_2018_definitions.xlsx)
Retrieved: 2026-09-23, effective version 2018
Authority: authoritative
Licence: U.S. Government work. Not subject to copyright protection in the United States (17 U.S.C. §105). (public_domain)
Attribution: Source: U.S. Bureau of Labor Statistics, 2018 Standard Occupational Classification
Export allowed: yes

## Availability
Free

## Authority
Authoritative

## Dataset kind
Reference list

## Worked example
```json
{
  "value": "11-1011",
  "displayValue": "Chief Executives",
  "description": "Management Occupations › Top Executives › Chief Executives",
  "aliases": [
    "11-1011",
    "Chief Executives"
  ],
  "metadata": {
    "code": "11-1011",
    "level": "detailed_occupation",
    "definition": "Determine and formulate policies and provide overall direction of companies or private and public sector organizations within guidelines set up by a board of directors or similar governing body. Plan, direct, or coordinate operational activities at the highest level of management with the help of subordinate executives and staff managers."
  },
  "ancestors": [
    {
      "value": "11-0000",
      "displayValue": "Management Occupations"
    },
    {
      "value": "11-1000",
      "displayValue": "Top Executives"
    },
    {
      "value": "11-1010",
      "displayValue": "Chief Executives"
    }
  ]
}
```

## Query it
```
/v1/query?key=YOUR_PUBLISHABLE_KEY&q=chief
```

A publishable key is public by design and belongs in client code as written; it is not a secret.

## Frequently asked questions

### What is in the SOC 2018 dataset?

The 2018 Standard Occupational Classification: 1,447 occupation codes across four levels, searchable by code or by title. Published by the U.S. Bureau of Labor Statistics. It has 1,447 items. Its source is U.S. Bureau of Labor Statistics. Authority: Authoritative. Licence: U.S. Government work. Not subject to copyright protection in the United States (17 U.S.C. §105). Refresh cadence: About once a decade; next revision expected around 2028.

### Is the SOC 2018 dataset free?

AutoSugges-published free datasets are never priced on their own — every plan includes all of them. What a plan prices is how many queries you may make, not which free list you may query. A few catalog entries are licensed from a third party or supplied by you, and those carry their own access terms, shown on that dataset's own page.

### How do I query SOC 2018?

Call GET /v1/query with your publishable key as the key parameter and the typed text as q, or mount the AutoSugges component for React, React Native or HTML. The runtime answers from the edge and never reads a database.

### What is the minimum number of characters before a query runs?

Two by default. A list owner can change the minimum, but it can never be 1. The client reads the real value from bootstrap and sends no request below it, so do not hardcode it.

### How long does the client wait after typing before it queries?

150 milliseconds by default. The value is delivered through bootstrap and a list owner can raise it, so the client uses the policy value rather than a constant.

### What happens when my query quota runs out?

The runtime returns a structured quota_exceeded response that carries no items and no placeholder suggestions, so exhaustion is never mistaken for no results. Render it from the typed error code and prompt an upgrade.

---
Canonical page: https://autosugges.com/datasets/soc-2018