Developers and Embeds
jobs.cards has a free, read-only JSON API and an embed widget. The Cards API returns any card by its serial number. The Pay API returns market pay, wage levels and filed pay for a job and place. Every card also has a share image and an embeddable version. Please link back.
API version 1
Embed a Card
Every card page has an Embed button that gives you this code. The card stays up to date and links back to its page. Add ?theme=dark or ?theme=light to fix the colours; without it the card follows the reader's device.
<iframe src="https://jobs.cards/embed/S-00001" title="jobs.cards S-00001" width="380" height="300" style="border:0;max-width:100%" loading="lazy"></iframe>
Share Images and Short Links
Each card has a 1200 × 630 image at /og/<serial>.png and a permanent short link at /c/<serial>. Serial numbers never change and are never reused.
Cards API
| Request | Returns |
|---|---|
GET /api/v1/cards/<serial> | One card with its facts, sources and related cards |
GET /api/v1/cards?type=salary&soc=15-1252&state=WA&page=1 | A list of cards. type: salary, employer, emp_job, job, deck, pulse. Optional filters: soc, state, employer (number), per (up to 50), facts=1 |
GET /api/v1/decks | Decks, largest first |
GET /api/v1/search?q=nurse | Jobs, employers and places that match |
GET /api/v1/suggest?kind=job&q=dat | Typeahead for job titles (kind=place for places) |
Pay API
| Request | Returns |
|---|---|
GET /api/v1/pay/market?soc=15-1252&area=42660 | BLS wage percentiles for a job. area: US, a state code, or a BLS metro code |
GET /api/v1/pay/levels?soc=15-1252&wage_area=42660 | Department of Labor wage levels I to IV, yearly dollars |
GET /api/v1/pay/filed?soc=15-1252&state=WA | Filed-pay summary: filings and the 5th to 95th percentile ladder. Use area for a metro or employer for one employer |
GET /api/v1/pay/check?job=software+developer&place=Seattle,+WA&pay=165000 | The offer check as data: market position, wage level, filed-pay position |
Rules
- Read-only, JSON, no key. Limit: 120 requests a minute per address. Responses are cached for up to an hour.
- Link back to the card or to jobs.cards where you show the data.
- Government data is in the public domain; cite the agency named in each response. Filed pay covers positions offered to foreign workers, base pay only.
- Occupation descriptions come from O*NET and keep this credit: This page includes information from the O*NET 31.0 Database by the U.S. Department of Labor, Employment and Training Administration (USDOL/ETA). Used under the CC BY 4.0 license. O*NET® is a trademark of USDOL/ETA.
- The API is provided as is and may change. Versioned under
/api/v1/.