# usajobs-extractor

US-government job listings via the public
[USAJOBS Search API](https://developer.usajobs.gov/api-reference/get-api-search) (`GET /api/Search` on `data.usajobs.gov`).

## Getting API access

1. Open the [USAJOBS Developer Site](https://developer.usajobs.gov/) and complete **USAJOBS API Access Request** (sign in / register as required).
2. After approval, USAJOBS emails your **API key** to the address you used—use that value for `USAJOBS_API_KEY`.
3. Set `USAJOBS_USER_AGENT` to a **real contact email** (same one you used for registration is typical). This is required by their terms, not optional branding—the HTTP `User-Agent` header must identify you.

Reference material on the developer site includes API Reference, tutorials, and code lists (locations, pay plans, etc.).

## Configuration

| Env / setting | Required | Notes |
| --- | --- | --- |
| `USAJOBS_API_KEY` / `usajobsApiKey` | yes | From the email USAJOBS sends after API access is granted |
| `USAJOBS_USER_AGENT` / `usajobsUserAgent` | yes | Real contact email per USAJOBS TOS |
| `usajobsMaxJobsPerTerm` | no | Per-term cap (default 100) |

The orchestrator's country gating restricts this source to the United States.