USAJOBS Federal Jobs Scraper by Series, Grade

What does USAJOBS Federal Jobs Scraper do?

It searches open federal job announcements on USAJOBS, the official US government jobs site, and returns clean structured records: title, agency, department, pay plan and grade, salary range, open and close dates, occupation series, locations, and the full announcement text (duties, qualifications, education, how to apply, agency contact). Filter by keyword, occupation series, GS grade, agency and location so a run returns only the openings you care about. Pricing is per result.

Data source

Public USAJOBS search results and job announcement pages, the same data any visitor sees on usajobs.gov, read live on every run. No login or API key is needed.

Why use it?

• Recruiters and staffing firms: track new openings by series and grade, and see the agency contact for each one.
• Job boards and career sites: feed a niche board (nursing, IT, contracting, law enforcement) with fresh federal listings.
• Researchers and analysts: study federal hiring by agency, series, location, pay plan and salary.
• Job seekers and coaches: build a daily list of GS 11 to 13 openings in one city without clicking through pages.
• It replaces manual browsing, saved search emails, and stale spreadsheet exports.

How to use it

1. Open the Actor and set the filters.
2. Click Start. Download results as JSON, CSV or Excel, or read them through the API.
3. Add a Schedule and an Integration (Slack, Google Sheets, webhook) to get new records automatically.

Input

Field	Description
keyword	Search words, as in the USAJOBS search box. Leave empty to list all open jobs.
location	City and state, state, or ZIP code, for example Washington, DC.
occupationSeries	Four digit OPM series codes, for example 2210 (IT management) or 0610 (nurse).
agency	Department names or codes (VA, DoD, Army, Navy, Air Force, DHS, DOJ, HHS, USDA, Treasury, State and others). Other text, such as Social Security, is matched against the agency name.
grades	GS grades to keep, for example 12, 13. A job is kept when its grade range covers any of them.
includeDetails	On by default. Opens each announcement to add duties, qualifications, how to apply, salary range, all locations and the agency contact. Turn off for a faster list only run.
maxResults	Hard stop for the run. You are billed per result, so this caps the cost.
proxyConfiguration	Apify proxy is recommended for larger runs.

Example input:

{
    "keyword": "data analyst",
    "location": "Washington, DC",
    "grades": ["12", "13"],
    "maxResults": 50
}

Output

Every record has the same shape. Fields with no value on the announcement are null. Example (long text trimmed):

{
    "id": "888446200",
    "title": "Medical Records Administration Specialist",
    "agency": "Veterans Health Administration",
    "department": "Department of Veterans Affairs",
    "location": "Oklahoma City, Oklahoma",
    "payPlanAndGrade": "GS 5 to 11",
    "salaryMin": 40736,
    "salaryMax": 97087,
    "payPeriod": "year",
    "openDate": "2026-10-10",
    "closeDate": "2026-10-20",
    "occupationSeries": "0669",
    "occupationName": "Medical Records Administration",
    "url": "https://www.usajobs.gov/job/888446200",
    "announcementNumber": "CBSU-13086650-27-TDG",
    "controlNumber": "888446200",
    "workSchedule": "Full-time - Monday - Friday, 8:00 AM - 4:30 PM",
    "appointmentType": "Permanent",
    "hiringPaths": ["Internal to an agency"],
    "locations": ["Oklahoma City, OK"],
    "locationCount": 1,
    "remote": false,
    "telework": "No",
    "relocation": "No",
    "travel": "Not required",
    "securityClearance": "Not Required",
    "supervisory": "No",
    "federalServiceType": "This job is in the Excepted Service",
    "positionSensitivity": "Non-sensitive (NS)/Low Risk",
    "vacancies": 1,
    "summary": "This position is located in the Health Information Management (HIM) Section...",
    "duties": "- Serves as a technical specialist and subject matter expert in health information management...",
    "conditionsOfEmployment": "- You must be a U.S. Citizen to apply for this job.\n- Selective Service Registration is required...",
    "qualifications": "Applicants pending the completion of educational or certification/licensure requirements...",
    "education": "Note: Only education or degrees recognized by the U.S. Department of Education...",
    "additionalInformation": "During the application process you may have an option to opt-in...",
    "howToApply": "All applicants are encouraged to apply online...",
    "contactName": "VISN 19 HR Contact Center",
    "contactEmail": "V19USAJOBS@VA.GOV",
    "contactPhone": "719-227-4600",
    "applyUrl": "https://www.usajobs.gov/Applicant/Application/ApplyStart/888446200",
    "scrapedAt": "2026-10-11T08:28:44.404Z"
}

Field	Meaning
id	USAJOBS control number. Stable, safe for deduplication between runs
title, agency, department	Job title, hiring agency, parent department
location	Location as shown in results, with a count when there are several
payPlanAndGrade	Pay plan and grade or grade range, for example GS 13 or GS 5 to 11
salaryMin, salaryMax, payPeriod	Advertised pay range in US dollars and its period
openDate, closeDate	Announcement window as YYYY-MM-DD
occupationSeries, occupationName	OPM series code and name
hiringPaths	Who may apply (public, veterans, federal employees and so on)
locations	Every duty location listed on the announcement
summary to howToApply	Announcement sections as plain text (only with includeDetails)
contactName, contactEmail, contactPhone	Agency contact published on the announcement

Pricing

Pay per event: a small fee when a run starts, then a fixed price per result returned. You only pay for records that pass your filters. Set maxResults to cap any run.

Limitations

• Only open announcements are returned. Closed jobs are not listed by USAJOBS.
• One search returns at most 10,000 jobs, the limit of the site itself. Narrow the filters to go deeper.
• Grade and agency name filters (other than the main departments) are applied after the search, so very narrow combinations scan more pages and take longer.
• Some announcements omit fields such as vacancies or contact email. Those come back as null.
• Positions with no GS grade (wage grade, Veterans Health Administration and other pay plans) are not kept when you set grades.

FAQ

Is this legal? The Actor reads listings the site publishes for any visitor without a login and stores only business information published for that purpose. You are responsible for how you use the data.

Do I need a USAJOBS API key? No.

Something is missing or broken? Open an issue in the Issues tab; response time is usually under a day.