Free salary data API & widgets

Add real, government-sourced salary figures to your site, app, or article — free, no API key, no sign-up. Built on BLS OEWS (US) and OECD/ILO data for 250+ roles. Use the JSON API or drop in an embeddable widget.

Free foreverNo API keyCORS-enabledGovernment data

The salary API

One GET request returns median, percentiles, hourly, and national comparison for any role and city.

Request

curl "https://officialsalary.com/api/salary?job=software-engineer&city=new-york"

Response

{
  "job": "software-engineer",
  "city": "new-york",
  "title": "Software Engineer",
  "cityName": "New York",
  "median": 208353,
  "p25": 170849,
  "p75": 262013,
  "hourly": 100,
  "currency": "USD",
  "source": "BLS OEWS / OECD / ILO via Official Salary",
  "url": "https://officialsalary.com/salary/software-engineer/new-york"
}

Params: job (required, slug like data-scientist), city (optional). Browse valid slugs in the directory. Please attribute with a link to the returned url.

Embeddable widgets

Drop a live salary card onto any page. The script embed is recommended — it renders inline and includes an attribution link. Customise with data-city, data-theme (light/dark), and data-accent.

Script embed (recommended)

<script src="https://officialsalary.com/api/widget/embed.js"
  data-job="software-engineer" data-city="new-york" data-theme="light"></script>

Iframe embed

<iframe src="https://officialsalary.com/api/widget/salary?job=software-engineer&city=new-york"
  width="340" height="200" frameborder="0" loading="lazy" title="Software Engineer salary"></iframe>
<a href="https://officialsalary.com/salary/software-engineer/new-york">Salary data by Official Salary</a>

Prefer a visual builder? Use the embed generator.

Citing the data

Free for editorial and commercial use with attribution. Cite as: "Official Salary, based on U.S. BLS OEWS and OECD/ILO data (officialsalary.com)." See the methodology and data sources for provenance.