Every score on NeedsAHuman is free to download, reuse and republish. The dataset is released quarterly under CC BY 4.0, with a full history of past releases.
Latest release: 2026-Q4. 923 occupations scored.
Downloads
Live scores: needsahuman-occupations.csv · needsahuman-occupations.json. Every job as it stands on the site today, one row per occupation: scores, grade, replacement range, verdict, employment and pay. Rewritten with every release.
Release files (the full dataset for each release, published with the pipeline’s public repository):
| File | What it is |
|---|---|
| occupations.csv | One row per occupation: scores, grades, ranges, verdict, employment and pay. Opens in any spreadsheet. |
| occupations.json | The same, plus each job’s full task list with task scores and its quality evidence. |
| schema.json | The JSON Schema for every field. |
| history.jsonl | Every job’s headline scores in every release, one line per job per release. |
| CITATION.cff | Citation metadata for reference managers. |
| changelog.md | What changed in each release. |
The pipeline code that builds the data is open source; a link to its repository will be added here.
Licence
The dataset is released under the Creative Commons Attribution 4.0 International licence (CC BY 4.0). You can copy, share, adapt and use it commercially, as long as you give credit.
Credit “NeedsAHuman.com” with a link to https://needsahuman.com/data/, and keep the upstream credits that come with the files:
- O*NET 31.0 database by the US Department of Labor, Employment and Training Administration (USDOL/ETA), used under CC BY 4.0. O*NET is a trademark of USDOL/ETA.
- Anthropic Economic Index, Anthropic PBC, CC BY.
- “Working with AI: Measuring the Occupational Implications of Generative AI”, Microsoft Research, CC BY 4.0.
- Employment, projections and pay: US Bureau of Labor Statistics (public domain).
- UK pay: Office for National Statistics, Annual Survey of Hours and Earnings, Open Government Licence v3.0.
Scores are NeedsAHuman’s own estimates. They do not represent the views of any data provider.
How to cite
NeedsAHuman.com (year of release). NeedsAHuman occupation scores, release 2026-Q4. CC BY 4.0. https://needsahuman.com/data/
To cite one job, use its page: each job page has a “Cite this page” box with the release and the date it was scored.
What’s in a row
| Field | Meaning |
|---|---|
onet_soc, soc_2018, uk_soc_2020 | Occupation codes: O*NET-SOC, US SOC 2018 and matching UK SOC 2020 codes. |
title, family_major, family_minor | Job title and its job family. |
coverage | Can AI do it? 0–100. |
qpi, qpi_grade | Is it better than a person? 0–100 (50 = parity) and the A–D evidence grade. Empty for grade D. |
qpi_imputed, qpi_model_value | Whether the quality value used in calculations was imputed, and that value. Never shown on the site as the job’s own result. |
ery_median, ery_low, ery_high, ery_label | When could it be replaced? Median year and 80% range. Empty means beyond 2060. |
ery_thin_evidence, ery_band | Whether evidence is thin, and the decade band shown instead of a precise year. |
nah_index, verdict_word | Still needs a human (0–100) and its verdict word. |
automate_share, augment_share | Of observed AI use, the share that is automation versus augmentation. |
us_employment, bls_change_2025_35 | US employment and the BLS projected change, 2025–35. |
us_median_pay, us_pay_p10, us_pay_p90, uk_median_pay | Pay, with the source year in the release notes. |
score_version, scored_date | The method version and the date the job was scored. |
The full list, with types, is in schema.json.
Versioning
- A release is a quarterly snapshot, named by quarter, for example
2026-Q4. - A score version is the version of the method. It changes only when the method changes, and every change is explained on the methodology page.
- Releases are never edited after publication. If we find an error, we publish a corrected release and log it on the corrections page.
API
For live data, the site has a small, free, read-only JSON API. No key is needed. Please cache responses and keep to a few requests a second.
| Endpoint | Returns |
|---|---|
GET /wp-json/nah/v1/rankings | All scored jobs as compact rows. Parameters: family, grade, sort (coverage, qpi, ery_median, nah_index, us_employment, us_median_pay, title), order, limit, offset. |
GET /wp-json/nah/v1/compare?jobs=a,b,c | Two or three jobs side by side, by slug. |
GET /wp-json/nah/v1/history/{slug} | One job’s scores across releases. |
For bulk use, download the files instead. The API serves the latest release only.
Changelog
What changed in each release is listed here, newest first, starting with the first public release.
Journalist kit
Writing about AI and jobs? The press page has headline figures from the latest release, ready-to-use charts, quotes and how to reach us.
Embed a badge
Every job page has a “Still needs a human” badge you can put on your own site. It updates when the score changes and links back to the job page. Copy the code from the “Cite this page” box on any job page.