O*NET occupations — titles, SOC codes, related jobs, job zones

Search or look up occupations in the ONET 30.3 Database (U.S. Department of Labor, Employment and Training Administration) and get one flat row per occupation: ONET-SOC code, title, description, job zone (preparation level 1–5) with its name, the sample of reported job titles, the ONET-related occupations with relatedness tier and rank, optional task statements, and the ONET OnLine link — ready for CSV or JSON. Three modes: fuzzy search by job title, lookup by O*NET-SOC / SOC code, and related (one row per related occupation of each given code).

The six O*NET tables the Actor needs are bundled in the image (3.9 MB), so a run makes no network request and finishes in seconds.

The default input (search "medical assistant", 25 rows) succeeds within 5 minutes and returns rows — Apify auto-tests it daily.

Data source and licence

This product includes information from the ONET 30.3 Database by the U.S. Department of Labor, Employment and Training Administration (USDOL/ETA). Used under the CC BY 4.0 license. ONET® is a trademark of USDOL/ETA. RetrainMap is not affiliated with or endorsed by USDOL/ETA.

Publisher	USDOL/ETA — the ONET Program, National Center for ONET Development (https://www.onetcenter.org/database.html)
What is bundled	ONET 30.3 text distribution files Occupation Data, Related Occupations, Job Zones, Job Zone Reference, Sample of Reported Titles, Task Statements — 1,016 occupations, 923 job-zone assignments, 18,460 related-occupation pairs, 18,796 task statements. Alternate Titles is not bundled (not available on the build machine); search therefore uses the ONET title and the sample of reported titles only
Refresh cadence	O*NET publishes a database release about quarterly; 30.3 is the release bundled here and every row carries onet_version. A newer release reaches this Actor only through a rebuild — check the version on the rows against https://www.onetcenter.org/database.html
Licence	Creative Commons Attribution 4.0 International (https://www.onetcenter.org/license_db.html). Keep the attribution line above with any redistribution of the rows. O*NET® is a trademark of USDOL/ETA
Known caveats	93 of the 1,016 occupations (mostly "All Other" aggregates and new/emerging codes) have no job zone, reported titles or related occupations; job_zone_name comes from O*NET's Job Zone Reference, which in 30.3 folds zones 1 and 2 into "Job Zone 1-2"; tasks is cut at 3,000 characters (tasks_truncated says when); search scores are a simple word-overlap heuristic, not a semantic match — check match_score and matched_on

Honesty note: the rows are the ONET tables joined by ONET-SOC code and flattened — nothing is inferred or classified by this Actor; the only computed values are match_score and matched_on in search mode (word overlap with light stemming: 100 = the query equals the O*NET title, 70–90 = the query's words are all in the title, 65 = equals a reported title, 50 = contained in a reported title, else 40 × word overlap — 10 to 15 means a single shared word, e.g. "Technicians"; matches below 10 are dropped), and a run stops with an error rather than guess when a bundled file's layout is not what it expects.

No requests leave the container, so there is no User-Agent to identify; the operator's contact is below.

Input

Field	Type	Meaning
mode	search / lookup / related	Default search
query	string	For search: a job title or a few words
soc_codes	array	For lookup / related: ONET-SOC codes (43-4051.00) or 6-digit SOC codes (43-4051 = every ONET code under it). An unknown code stops the run
include_tasks	boolean	Add task statements (default false)
max_records	integer	Default 100, at most 20,000

Example — the related occupations of customer service representatives and heavy-truck drivers, with tasks:

{ "mode": "related", "soc_codes": ["43-4051.00", "53-3032"], "include_tasks": true, "max_records": 50 }

Output (dataset row)

onet_soc_code, title, description, job_zone (1–5), job_zone_name, reported_titles (joined with ; ), related_occupations (code Title [tier #index], joined with ; ), related_count, tasks (joined with |, when include_tasks), tasks_count, tasks_truncated, match_score and matched_on (search mode), related_to_code, related_to_title, relatedness_tier (Primary-Short / Primary-Long / Supplemental) and relatedness_index (related mode), onet_online_url, onet_version, fetched_at, source (the attribution line).

A run summary (input, candidate count or resolved codes, rows pushed, licence and attribution) is stored as RUN_SUMMARY in the run's key-value store.

Pricing (pay per event)

Event	Price
run-start — once per run	$0.10
record — per row written	$0.005

The default search (≤ 25 rows) costs at most $0.225; all 1,016 occupations cost $5.18. Rows stop when your run's maximum charge is reached; the run summary says so.

Operator

Steelyard Ventures LLC (RetrainMap) — info@steelyardclinical.com. Not affiliated with or endorsed by USDOL/ETA or the O*NET Program. The Actor writes only to its own dataset and key-value store; it stores no credentials and sends nothing anywhere.