USAJobs Federal Scraper: US Government Jobs

Extract US federal government job listings from USAJobs.gov, the official job board for all US federal agencies. Covers ~30,000 open positions across every department, from entry-level to Senior Executive Service.

Built on the official USAJobs public REST API. No browser automation, no HTML parsing, no captcha.

What it does

Pulls live federal job listings from the USAJobs API. Filter by keyword, location, GS pay grade, agency, or remote status. Each run returns structured data including the full description, pay scale, security clearance requirement, occupational series code, application deadline, and eligible hiring paths (public, veterans, students, etc.).

Sample output

{
  "_type": "job",
  "id": "805030100",
  "title": "Software Engineer",
  "job_url": "https://www.usajobs.gov/job/805030100",
  "source_url": "https://www.usajobs.gov/job/805030100",
  "source_platform": "usajobs.gov",
  "company_name": "Department of the Air Force",
  "company_website": "https://www.airforce.com",
  "location": "Wright-Patterson AFB, Ohio",
  "country": "US",
  "posted_at_text": "2026-08-01T00:00:00.0000000",
  "posted_at_datetime": "2026-08-01T00:00:00Z",
  "closing_at_text": "2026-08-22T00:00:00.0000000",
  "closing_at_datetime": "2026-08-22T00:00:00Z",
  "employment_type": "full-time, permanent",
  "pay_grade": "GS-13",
  "pay_min": 94199,
  "pay_max": 122459,
  "pay_currency": "USD",
  "pay_period": "year",
  "security_clearance": "Top Secret",
  "travel_percentage": "25% or less",
  "remote_type": "on-site",
  "description": "We are seeking a Software Engineer to join our team...",
  "description_full": "We are seeking a Software Engineer to join our team...\n\nDuties:\n- Design and develop software systems...",
  "description_html": "<p>We are seeking a Software Engineer...</p><ul><li>Design...</li></ul>",
  "description_md": "We are seeking a Software Engineer to join our team...\n\n- Design and develop software systems...",
  "contact_emails": [],
  "contact_phones": [],
  "contact_urls": [],
  "agency_hierarchy": ["Department of the Air Force", "Air Force Materiel Command"],
  "job_category_code": "2210",
  "job_category_name": "Information Technology Management",
  "application_url": "https://apply.usastaffing.gov/Application/Apply",
  "announcement_number": "AFMC-12345678-A-DIRECT",
  "hiring_path": ["public", "veterans"],
  "search_query": "software engineer",
  "scraped_at": "2026-08-22T10:30:00Z"
}

Pricing

Event	Price
Actor start	$0.001
SERP result (includeJobDetails=false)	$0.003 per job
Detail result (includeJobDetails=true)	$0.005 per job

Typical cost: $3 per 1,000 jobs in SERP mode (all structured fields from the API are included). Detail mode ($5/1,000) populates the full HTML description fields.

New to Apify? Every account gets a $5 free monthly platform credit - enough for around 1,000 results before you pay anything.

Input

Field	Type	Default	Description
searchQueries	array of strings	-	Keywords like "software engineer", "data analyst". Each runs as a separate search. Leave empty to browse all federal jobs.
startUrls	array of strings	-	USAJobs.gov search URLs. Wins over searchQueries when both are set.
location	string	-	City or state filter, e.g. "Washington, DC", "Texas".
includeJobDetails	boolean	false	Enable description fields (description_full, description_html, description_md). Charges job-detail-result.
includeCompanyDetails	boolean	false	Surface agency marketing URL as company_website. No extra requests.
payGradeMin	string	-	Minimum GS grade. Accepts "GS-13" or "13".
payGradeMax	string	-	Maximum GS grade.
remoteOnly	boolean	false	Return only remote or telework-eligible positions.
agency	string	-	Agency or department name substring, e.g. "Department of Defense", "NASA".
maxResults	integer	5	Total cap across all queries (max 1000).
maxResultsPerQuery	integer	5	Cap per individual keyword.

Output fields

Identity

• id: USAJobs control number
• title: official position title
• job_url, source_url: canonical USAJobs.gov listing URL
• announcement_number: official vacancy announcement number

Agency / Company

• company_name: hiring agency or organization
• company_website: agency marketing URL (when available)
• agency_hierarchy: ordered list from department to sub-agency

Location

• location: primary location display string
• country: always "US"
• remote_type: "remote" or "on-site"

Pay

• pay_grade: GS grade (e.g. "GS-13" or "GS-13/14" for grade ranges)
• pay_min, pay_max: salary bounds in USD
• pay_currency: always "USD"
• pay_period: "year", "hour", "biweekly", etc.
• employment_type: comma-joined tokens - full-time, permanent, temporary, term, etc.

Description

• description: short single-line snippet (~500 chars)
• description_full: full plain text with line breaks
• description_html: raw HTML from the API
• description_md: Markdown rendering (headings, lists, links preserved)

Contacts

• contact_emails[]: emails extracted from description
• contact_phones[]: phones extracted from description
• contact_urls[]: external URLs extracted from description

Federal-specific

• security_clearance: required clearance level
• travel_percentage: expected travel
• job_category_code: federal occupational series code
• job_category_name: occupational series name
• hiring_path: eligible hiring paths (public, veterans, students, graduates, etc.)
• application_url: external ATS or application portal link

Meta

• posted_at_datetime, closing_at_datetime: ISO 8601 UTC
• search_query, scraped_at

Use with AI Agents

This actor is available as an MCP tool:

https://mcp.apify.com?tools=santamaria-automations/usajobs-federal-scraper

Point any MCP-compatible agent at that URL to let it search and retrieve federal job listings on demand.

Why this scraper

• Official API: data comes directly from the USAJobs public REST API - no scraping, no blocking, no captchas
• GS pay grade + salary range: structured pay data on every row, not buried in description text
• Security clearance field: dedicated field for clearance requirements - useful for defense/intel recruiting
• Hiring path filter: federal jobs are gated by eligibility (veterans, students, public) - surfaced per listing
• Occupational series codes: federal jobs use standardized 4-digit series codes (2210=IT, 0343=Management Analyst, etc.) - useful for market analysis

Common use cases

• Defense and government contractor recruiting (identify open roles before candidates apply)
• Federal job market analysis by agency, location, or GS grade
• Veteran hiring research (filter by hiring_path: veterans)
• Remote federal job boards (filter by remoteOnly: true)
• Salary benchmarking using GS pay tables

Related Actors

• Job Feed - aggregate jobs from 25+ boards in one dataset
• Career Site Jobs Scraper - extract jobs from any company careers page
• Website Job Extractor - pull job postings from any URL
• Indeed Scraper - scrape Indeed.com (includes US federal jobs posted there)
• Rigzone US Scraper - US oil, gas and energy jobs
• ZipRecruiter Scraper - US job board with strong federal presence

Support

Found an issue or have a question? Open a ticket via the Issues tab or email contact@nanoscrape.com - we reply within 6 hours on business days.