# bluedoor - H-1B jobs data

H-1B sponsoring employers, DOL OFLC LCA role declarations, offered wages,
worksites, ZIP market summaries, quarterly LCA trends, USCIS employer petition
summaries, and source evidence. Data pages are server-rendered from the
bluedoor H-1B Jobs API and show the exact API calls used to render each page.

Base API: https://api.bluedoor.sh/h1b-jobs/v1
Docs: https://bluedoor.sh/apis/h1b-jobs/docs
Get an API key: https://bluedoor.sh/apis/h1b-jobs

JSON convention: each "Get this page with API" block links to the same-origin
proxy /api/h1b/<api-path>, which mirrors the api.bluedoor.sh path shown on the
page and keeps API credentials server-side.

## Indexes
- https://bluedoor.sh/data/h1b-jobs - data home
- https://bluedoor.sh/data/h1b-jobs/companies - employer lookup index
- https://bluedoor.sh/data/h1b-jobs/roles - bounded LCA role rows
- https://bluedoor.sh/data/h1b-jobs/wages - bounded wage observations
- https://bluedoor.sh/data/h1b-jobs/markets - ZIP market summaries
- https://bluedoor.sh/data/h1b-jobs/trends - quarterly aggregate trends
- https://bluedoor.sh/data/h1b-jobs/search - bounded query router
- https://bluedoor.sh/data/h1b-jobs/indexes - all browseable indexes

## Page types
- Company hub: /data/h1b-jobs/companies/<company>
  - sections: /roles, /wages, /trends
- ZIP market hub: /data/h1b-jobs/markets/<postal-code>
  - sections: /roles, /wages, /trends
- Exact title slice: /data/h1b-jobs/roles/titles/<title>/states/<STATE>/years/<FY>
- SOC slice: /data/h1b-jobs/roles/occupations/<SOC>/states/<STATE>/years/<FY>

## API routes
- /v1 - route map, freshness, and caveats
- /v1/companies - employer profile lookup
- /v1/roles - row-level LCA role declarations
- /v1/wages - compensation-first observations and returned-page summaries
- /v1/trends - loaded-LCA time series
- /v1/markets - ZIP/place labor-market summaries
- /v1/openapi.json - OpenAPI schema

## Supported row access patterns
- company=<name>
- state=<STATE>&postal_code=<ZIP>
- title=<exact title>&title_match=exact&state=<STATE>&fiscal_year=<FY>
- soc_code=<SOC>&state=<STATE>&fiscal_year=<FY>

## Caveats
- LCA records are labor-condition applications, not active job postings.
- LCA certification is not USCIS petition approval.
- USCIS employer summaries and DOL LCA rows come from different source systems.
- Broad row scans are planner-bounded; use company, ZIP, title/state/year, or SOC/state/year filters.