Pull new USAJOBS federal job announcements for your keywords, duty locations, GS grade and hiring path, and get only the jobs you haven't seen yet, every day.
Written with AI assistance and reviewed by the FedSignals Data team; we maintain these tools.
Every US federal civilian job opening is announced on USAJOBS. On a weekday that is often more than a thousand new announcements, from GS-5 clerks to GS-15 data scientists, across every agency and duty station. If you are job hunting, coach veterans or military spouses, run a career center or a niche job board, the hard part isn't finding the jobs. It's getting the new ones that fit, every morning, without re-reading the same list.
USAJOBS has saved-search emails, and it has an official, free Search API. Turning either into a clean daily feed takes some work:
- Saved-search emails land in one inbox. You can't easily send them to Slack, a spreadsheet, a newsletter or your own matching script.
- The USAJOBS Search API is free, but you need to learn its parameters, page through results, normalize grades and salaries, drop the hiring contacts, and remember which jobs you already handled.
We built the USAJOBS Federal Jobs Feed Actor on Apify to do that part, and this tutorial walks through it. It calls the official USAJOBS Search API with your own free API key (no scraping, no login), filters by keyword, location, remote, GS grade, salary, security clearance and hiring path, and returns only jobs it hasn't delivered before.
What you'll build
- A daily list of new federal jobs for the keywords, states and GS grades you pick, with agency, grade, salary, duty locations, clearance, close date and a link to the official announcement.
- A daily run that returns, and charges for, only jobs it hasn't delivered before.
- A Slack message (or a webhook to your own app) with each morning's new jobs.
Step 0: Get your free USAJOBS API key
USAJOBS gives every developer a free key, and its API terms don't allow sharing keys between users, so the Actor uses yours:
- Fill in the free request form at https://developer.usajobs.gov/APIRequest/Index.
- Open the verification link USAJOBS emails you.
- USAJOBS then emails you your API key.
You'll paste the key into usajobsApiKey and the email you registered with into usajobsEmail. The key field is a secret input: Apify stores it encrypted, and the Actor sends it only to USAJOBS. It is never logged or written to the dataset. Never paste the key into code you share; the Python below reads it from an environment variable.
Step 1: Run it once by hand
Open apify.com/fedsignals/usajobs-federal-jobs-feed, click Try for free, and use an input like this (with your own key and email):
{ "usajobsApiKey": "YOUR_USAJOBS_API_KEY", "usajobsEmail": "you@example.com", "keywords": "data analyst, data scientist", "locations": ["Virginia", "Maryland"], "gradeMin": 11, "hiringPaths": ["public"], "postedWithinDays": 7, "onlyNew": false, "maxItems": 5 } It asks for data analyst and data scientist jobs at GS-11 and above, with a duty location in Virginia or Maryland, open to the public, posted in the last 7 days. Each keyword is a separate USAJOBS search, and the results are merged. Locations accept a state name (Virginia), a 2-letter code (VA), City, State (Denver, Colorado) or a country for overseas posts (Japan). A misspelled state such as Virginnia stops the run before any job is charged, with a "Did you mean 'Virginia'?" message. The run takes a few seconds, and with maxItems: 5 it costs at most about half a cent.
Step 2: Look at the output
Each row is one job announcement. Here is one from a real run (Nov 12, 2026):
{ "jobId": "892609400", "announcementNumber": "DHRA-DSSC-27-13095891-DHA", "title": "Interdisciplinary", "agency": "Defense Human Resources Activity", "subAgency": "Defense Support Services Center (DSSC)", "department": "Department of Defense", "locations": ["Alexandria, Virginia"], "countries": ["United States"], "remote": false, "teleworkEligible": true, "payPlan": "GS", "grade": "GS-14", "gradeLow": 14, "gradeHigh": 14, "salaryMin": 143913, "salaryMax": 187093, "salaryInterval": "year", "currency": "USD", "schedule": "Full-time", "appointmentType": "Permanent", "hiringPaths": ["Open to the public"], "seriesCodes": ["0180", "1515", "1530"], "seriesNames": ["Psychology", "Operations Research", "Statistics"], "clearance": "Secret", "totalOpenings": "1", "openDate": "2026-11-12", "closeDate": "2026-11-22", "closesAt": "2026-11-22T23:59:00-05:00", "daysUntilClose": 10, "closingSoon": false, "url": "https://www.usajobs.gov/job/892609400", "source": "USAJOBS (data.usajobs.gov Search API)", "scrapedAt": "2026-11-12T16:59:50Z" } A few fields worth knowing:
-
gradeis normalized (GS-14, orGS-12/13for a ladder), withgradeLowandgradeHighas numbers you can sort and filter on. -
salaryMin/salaryMaxare numbers in US dollars (currency: "USD") persalaryInterval(usuallyyear). -
remotemeans fully remote.teleworkEligiblemeans there is a duty station but some days at home are allowed. They are not the same thing. -
openDateandcloseDateare calendar dates. Announcements usually close at 11:59 PM US Eastern oncloseDate;closesAtcarries that deadline with its UTC offset, andclosingSoonis true when a job closes within 7 days. -
urlis the official announcement, where you apply. Hiring-contact names, emails and phone numbers are never output, and neither is the announcement text.
Every run also writes a SUMMARY record to its key-value store. It shows your filters, the matches per keyword search, what was skipped and why the run stopped (this is the same run; byState trimmed):
{ "filters": { "keywords": ["data analyst", "data scientist"], "locations": ["Virginia", "Maryland"], "remoteOnly": false, "gradeMin": 11, "gradeMax": null, "salaryMin": null, "securityClearance": [], "hiringPaths": ["public"], "postedWithinDays": 7 }, "searches": [ {"keyword": "data analyst", "totalMatching": 4, "pages": 1, "inWindow": 4}, {"keyword": "data scientist", "totalMatching": 4, "pages": 1, "inWindow": 4} ], "scanned": 8, "matched": 8, "delivered": 5, "skippedAlreadySeen": 0, "skippedClearance": 0, "skippedSalary": 0, "skippedGrade": 0, "skippedNotRemote": 0, "closingSoon": 2, "byDepartment": { "Department of Defense": 2, "Department of Health and Human Services": 1, "Department of Commerce": 1, "Other Agencies and Independent Organizations": 1 }, "byState": {"Maryland": 4, "Virginia": 1, "Texas": 2, "District of Columbia": 1}, "stopReason": "maxItems", "maxItems": 5, "onlyNew": false, "partialFailures": [], "firstRunForState": false, "requests": 2, "finishedAt": "2026-11-12T16:59:51Z" } Eight jobs matched and five were delivered, because maxItems was 5 (stopReason: maxItems). byState counts every duty location of the delivered jobs, so a job listed in 18 cities adds to 18 states.
Step 3: Call it from Python
This runs the Actor synchronously and prints each new job. It reads your Apify token and your USAJOBS key and email from environment variables (never paste them into code). maxTotalChargeUsd caps what the run can charge.
import os import requests ACTOR = "fedsignals~usajobs-federal-jobs-feed" URL = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items" run_input = { "usajobsApiKey": os.environ["USAJOBS_API_KEY"], # your free USAJOBS key (secret) "usajobsEmail": os.environ["USAJOBS_EMAIL"], # the email you registered it with "keywords": "data analyst, data scientist", "locations": ["Virginia", "Maryland"], "gradeMin": 11, "hiringPaths": ["public"], "postedWithinDays": 7, "onlyNew": True, # only jobs this stateKey hasn't returned before "stateKey": "fed-data-jobs-va-md", # one key per saved search "maxItems": 3, } resp = requests.post( URL, params={"maxTotalChargeUsd": 0.01}, headers={"Authorization": f"Bearer {os.environ['APIFY_TOKEN']}"}, json=run_input, timeout=300, ) resp.raise_for_status() for n in resp.json(): soon = " (closing soon)" if n["closingSoon"] else "" where = ", ".join(n["locations"][:2]) + (" +more" if len(n["locations"]) > 2 else "") print(f"{n['jobId']} {n['grade']} closes {n['closeDate']}{soon}: {n['title']}") print(f" {n['agency']} · {where} · {n['url']}") Run it twice. The second run doesn't repeat anything from the first: onlyNew remembers every job delivered for that stateKey, skips those for free, and moves on to jobs you haven't seen. In a daily schedule that means each run returns only what was posted since the day before.
Other inputs we use a lot:
-
gradeMaxandsalaryMin: cap the grade (e.g. GS-11 to GS-13) or keep only jobs whose pay range reaches a yearly amount. Setting a grade keeps only General Schedule jobs (GS, GL, GG, GM). -
remoteOnly: only fully remote jobs. -
hiringPaths: who may apply, e.g.public,vet,mspouse,student,graduates. Career programs for veterans or military spouses can run one task per group.
There is no agency input in this build. Agency names are messy across USAJOBS (department, agency and sub-agency), so the quickest way to narrow by agency is to add its name or mission words to keywords. If you also filter on department or agency in your own code after the run, keep in mind that jobs you drop there were still delivered and charged.
Step 4: Security clearance is a post-filter
You can ask for jobs that require a given clearance with securityClearance (notRequired, confidential, secret, topSecret, sci, qAccess, lAccess, other). One limit to know: USAJOBS documents a SecurityClearanceRequired search parameter, but in our tests (Nov 3, 2026) the API ignored it. So the Actor downloads the matching jobs and checks the clearance itself:
- Jobs with another clearance are skipped for free and counted in
SUMMARY.skippedClearance. - USAJOBS returns at most 10,000 jobs per search, newest first. A clearance filter with no keywords or locations over a long window (say 60 days) can only check the newest 10,000; when that happens the run says so with
stopReason: scanLimit. Add a keyword or location, or use a shorterpostedWithinDays, and the whole window is covered.
Salary (salaryMin) and the exact grade overlap are checked the same way, after download.
Step 5: Schedule it daily
- In the Apify console, click Save as a new task with your key, email, keywords, locations and grades. Keep
onlyNew: trueand set astateKey. - Go to Schedules → Create new, use the cron expression
0 7 * * *(7:00 daily), set your timezone, and attach the task.
postedWithinDays can stay at 3 (the default): thanks to onlyNew, the overlap between days costs nothing.
Step 6: Send new jobs to Slack or a webhook
Add a webhook for ACTOR.RUN.SUCCEEDED that points at a small function you host. The payload includes resource.defaultDatasetId:
import os import requests def handler(payload: dict) -> None: dataset_id = payload["resource"]["defaultDatasetId"] jobs = requests.get( f"https://api.apify.com/v2/datasets/{dataset_id}/items", headers={"Authorization": f"Bearer {os.environ['APIFY_TOKEN']}"}, timeout=60, ).json() if not jobs: return # nothing new today lines = [f"*{len(jobs)} new federal job{'s' if len(jobs) != 1 else ''}*"] for n in jobs[:30]: soon = " (closing soon)" if n.get("closingSoon") else "" lines.append( f"• <{n['url']}|{n['title'][:90]}> {n['grade']} · {n['agency']} · closes {n['closeDate']}{soon}" ) requests.post(os.environ["SLACK_WEBHOOK_URL"], json={"text": "\n".join(lines)}, timeout=30) What it costs
Pay per result: $0.001 per job ($1 per 1,000), plus Apify's $0.00005 run-start fee. A daily run that returns 25 new jobs costs about $0.025, or about $0.75 a month. A run with nothing new costs only the start fee. Already-seen and filtered-out jobs are skipped for free. Set maxItems or a maximum charge per run to cap the cost; the run stops cleanly before going over it (start fee included). If the input or the key is invalid, the run stops before any job is charged; only the start fee applies. USAJOBS itself charges nothing for the key.
FAQ
Why do I need my own USAJOBS API key?
USAJOBS gives every user a free key, and its API terms don't allow sharing or transferring credentials, so one key can't be shared between users.
My run failed with "USAJOBS rejected the API key".
Check that the key is the one USAJOBS emailed you and that usajobsEmail is the exact email you registered it with. No job is charged.
Why did my run return no jobs?
The status message says why: nothing new since the last run (with onlyNew), every match filtered out by grade, clearance or salary, or no matches at all. Try more postedWithinDays or fewer filters. The SUMMARY record shows the totals for each search.
Does it include the full job description?
No. Announcement bodies often name contact people, so the dataset keeps the structured fields only. The full announcement is at url.
Does it cover state and local government jobs?
No. USAJOBS lists US federal jobs only, including federal posts in US territories and overseas (for example at bases in Japan or Germany).
Related
- How to Get Daily SAM.gov Contract Opportunity Alerts in Slack: the same daily-alert pattern for U.S. federal contracts.
- How to Get Daily World Bank Tender Alerts by Country and Keyword: the same pattern for World Bank-financed procurement.
Last updated: Nov 12, 2026 (tested against Actor build 0.1.11).
FedSignals Data builds small public-data monitors on Apify. Source: USAJOBS (https://www.usajobs.gov), through the USAJOBS Search API (https://developer.usajobs.gov). Every row links to the official job announcement and carries its retrieval date (scrapedAt); fields are renamed and reformatted, and contact details and announcement text are omitted. This product is not operated, sponsored, approved, or endorsed by OPM or USAJOBS. Apply via the official announcement on USAJOBS. Questions or feature requests: fedsignals.alerts@gmail.com.
