Opens in a new tab
needsahuman.

Open data: every score, every release

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.

Every score on NeedsAHuman is free to download, reuse and republish. The dataset is released quarterly under , 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):

FileWhat it is
occupations.csvOne row per occupation: scores, grades, ranges, verdict, employment and pay. Opens in any spreadsheet.
occupations.jsonThe same, plus each job’s full task list with task scores and its quality evidence.
schema.jsonThe JSON Schema for every field.
history.jsonlEvery job’s headline scores in every release, one line per job per release.
CITATION.cffCitation metadata for reference managers.
changelog.mdWhat 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 Applicability of Generative AI to Occupations”, 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

FieldMeaning
onet_soc, soc_2018, uk_soc_2020Occupation codes: O*NET-SOC, US SOC 2018 and the matching UK SOC 2020 codes.
slug, title, urlThe job’s title and the address of its page.
family, family_name, family_minor, family_minor_nameThe job family and sub-family (SOC major and minor group), as slug and name.
coverageCan AI do it? 0–100.
qpi, qpi_grade, qpi_imputedIs it better than a person? 0–100 (50 = parity), the A–D evidence grade (empty for grade D), and whether the value used in calculations was imputed from similar jobs.
ery_median, ery_low, ery_highWhen could it be replaced? Median year and 80% range. Empty means beyond 2060.
nah_index, verdict_wordStill needs a human (0–100, higher is safer) and its verdict word.
automate_share, augment_shareOf observed AI use, the share that is automation versus augmentation.
us_employment, bls_change_2025_35, us_median_payUS employment, the BLS projected change in percent for 2025–35, and median annual pay.
uk_employment_estEstimated UK employment for the matching UK SOC 2020 codes.
score_version, scored_date, releaseThe method version, the date the job was scored and the release it belongs to.

The JSON download has the same fields, one object per job.

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.

EndpointReturns
GET /wp-json/nah/v1/rankingsAll 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,cTwo 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.