Wage Data API: H-1B employer and occupation wage percentiles as JSON

What it returns

Percentiles of filed wages for an employer or an occupation, joined to BLS OEWS benchmarks, with a source and attribution block in every response. A successful response is a JSON object with data, attribution (sources, notice, provider) and meta.

Endpoints (key required except health and the OpenAPI document)
Endpoint	What it does
`GET /v1/wages/employer/:slug`	Filed wage percentiles for one employer
`GET /v1/wages/employer?name=&title=`	Look up an employer by name, optionally narrowed to a job title
`GET /v1/wages/occupation/:soc?metro=`	Occupation percentiles for a SOC code in a metro, or a list of metros
`GET /v1/wages/occupation?title=&state=&city=`	Match a job title to OEWS percentiles (metro, then state, then national)
`GET /v1/wages/search?q=&type=`	Search employers or occupations
`GET /v1/usage`	Your usage (not metered)

Send the key as X-API-Key: YOUR_KEY or Authorization: Bearer YOUR_KEY. The full description is the public OpenAPI document.

curl -H "X-API-Key: YOUR_KEY" \
  https://data-api.premed-toolkit.workers.dev/v1/wages/employer/amazon

Plans

Wage Data API plans
Plan	Price	Successful calls per month	Rate limit
Free	$0	100 successful calls a month	10 a minute
Basic	$9 a month	5,000	60 a minute
Pro	$29 a month	50,000	300 a minute
Ultra	$99 a month	500,000	600 a minute

Direct checkout is not open yet: key delivery is manual until a fulfilment worker exists. To pay today, subscribe on the RapidAPI listing, an alternative billing route. Read the API docs first; the machine-readable spec is the OpenAPI document.

Coverage

The API is built from the same rules as the 10,250 employer and 2,993 job-and-metro pages published here, and also serves smaller job-and-metro groups in any metro; the loaded set grows as data is added, so check the docs for current coverage. The same caveat as everywhere: filed wages are the bottom of each filing's offered range, see the methodology.

Prefer a runner?

Two Apify actors wrap the same data for batch lookups: H-1B employer wage lookup and occupation salary by metro. See each actor page for its current pricing.

Questions

How do I get a key?

There is no self-serve key signup on this site yet; direct keys are issued by hand. You can also subscribe through the RapidAPI listing, which handles billing and access. Join the list below for API updates.

Do failed calls use my quota?

No. Only successful GET responses count toward the quota. Client and server errors are refunded, and HEAD requests are never metered.

Why does a lookup say not found?

The API serves every employer and job-and-metro group with at least 5 certified filings in the data it has loaded, which is a larger set than the pages published here; groups under 5 filings are suppressed and some names will not match.