USAJobs.gov Scraper: Extract Federal Job Search Results Instantly

---

What Is USAJobs.gov?

USAJobs.gov is the official U.S. government job portal administered by the Office of Personnel Management (OPM). It lists hundreds of thousands of federal positions across agencies, from entry-level internships to senior leadership roles. For recruiters, job aggregators, and career researchers, accessing this data manually is inefficient — the USAJobs Scraper automates the collection of search results, delivering structured federal job data ready for analysis and integration.

---

Overview

The USAJobs Jobs Search Scraper extracts job listings from USAJobs search results pages, converting human-readable listings into clean, structured records. It is designed for:

• Federal recruiters tracking agency hiring trends
• Job board aggregators syndicating government positions
• Career analysts researching federal employment markets
• HR professionals benchmarking federal compensation and hiring practices

Key strengths include configurable result limits per search page, robust error handling via ignore_url_failures, and comprehensive output covering agency, salary, location, and hiring eligibility data.

---

Input Format

The scraper accepts a JSON configuration object:

{
  "urls": [
    "https://www.usajobs.gov/Search/Results?k=software&l=Washington%2C+DC&p=2&r=25"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}

Input Parameters

Parameter	Type	Description
urls	Array	USAJobs search results pages to scrape. Include the full URL with query parameters (keyword, location, page number, result limit).
ignore_url_failures	Boolean	If true, the scraper continues even if some URLs fail. Prevents interruptions during large batch runs.
max_items_per_url	Integer	Maximum number of job listings to extract per URL (e.g., 20).

Example URLs:

• Search by keyword: https://www.usajobs.gov/Search/Results?k=software
• Filtered by location: https://www.usajobs.gov/Search/Results?k=software&l=Washington%2C+DC
• Paginated results: https://www.usajobs.gov/Search/Results?k=software&p=2&r=25

Tip: Build search URLs directly from USAJobs.gov, then copy them into the scraper configuration. URL parameters are preserved to maintain search context.

---

Output Format

Sample output

{
  "title": "Foreign Service Consular Fellow - Arabic, Mandarin Chinese, Portuguese, and/or Spanish Proficiency",
  "agency": "Department of State - Agency Wide",
  "department": "Department of State",
  "salary_display": "Starting at $59,726 Per year (FP 6)",
  "document_id": null,
  "position_id": null,
  "location": "Department of State Posts - Overseas and Domestic",
  "location_display": "Department of State Posts - Overseas and Domestic (265 locations)",
  "date_display": "Open 04/01/2026 to 09/30/2026",
  "work_schedule": "Full-Time",
  "work_type": "The appointment is a limited non-career appointment for up to 60 months.",
  "posted_date_display": "Posted 04/01/26",
  "hiring_path": [
    {
      "code": "public",
      "tooltip": "Jobs open to U.S. Citizens, Nationals or those who owe allegiance to the U.S.",
      "is_search_filter": false,
      "search_display": "Open to the public"
    }
  ],
  "low_grade": "06",
  "high_grade": "06",
  "job_grade": "FP",
  "location_name": "Montevideo, Uruguay",
  "position_location_count": "265",
  "position_uri": null,
  "relocation": "True",
  "minimum_range": "59726",
  "position_start_date": "2026-04-01T00:00:00.0000",
  "position_end_date": "2026-09-30T23:59:59.9970",
  "sub_agency": null,
  "announcement_closing_type": "01",
  "job_category_code": [
    {
      "name": "Passport And Visa Examining",
      "code": "0967"
    }
  ],
  "from_url": "https://www.usajobs.gov/Search/Results?k=software&l=Washington%2C+DC&p=2&r=25"
}

Each job listing returns a structured record with 21 fields across job identity, agency, location, compensation, and hiring criteria:

Job Identity & Metadata

Field	Meaning	Example
Title	Official job title	"Software Engineer"
Document ID	Unique USAJobs document identifier	"12345678"
Position ID	Agency-specific position number	"POS-2024-001"
Position URI	Direct link to the job listing	"https://www.usajobs.gov/GetJob/..."

Agency & Organization

Field	Meaning	Example
Agency	Federal agency name	"Department of Defense"
Sub Agency	Sub-division within the agency	"Defense Information Systems Agency"
Department	Broader department classification	"Executive Branch"

Location & Work Arrangements

Field	Meaning	Example
Location	Standardized work location code	"DC"
Location Display	Human-readable location(s)	"Washington, DC"
Location Name	Full location name	"Washington, District of Columbia"
Position Location Count	Number of open positions across locations	"3"
Relocation	Whether relocation assistance is offered	true or false

Compensation & Grade

Field	Meaning	Example
Salary Display	Formatted salary range	"$75,000 - $95,000/year"
Minimum Range	Low end of salary band	"75000"
Low Grade	Lowest federal GS grade offered	"GS-11"
High Grade	Highest federal GS grade offered	"GS-13"
Job Grade	Primary GS grade level	"GS-12"

Work Details & Eligibility

Field	Meaning	Example
Work Schedule	Full-time, part-time, or flexible	"Full-time"
Work Type	Permanent, temporary, or term	"Permanent"
Hiring Path	Eligibility category (e.g., public, vet, intern)	"Veterans" or "Recent Graduates"
Announcement Closing Type	Cutoff method for applications	"Continuous" or "Specific date"

Dates

Field	Meaning	Example
Posted Date Display	When the listing was published	"2024-01-15"
Position Start Date	Earliest start date for the role	"2024-02-01"
Position End Date	Latest start date or listing end date	"2024-06-30"
Date Display	User-friendly date range	"Posted Jan 15, 2024"

Classification

Field	Meaning	Example
Job Category Code	OPM occupational series code	"2210" (Information Technology)

---

How to Use

1. Build search URLs — Navigate to USAJobs.gov, apply your filters (keyword, location, experience level), and copy the resulting page URL.
2. Add URLs to config — Paste URLs into the urls array. Multiple search pages are supported.
3. Set result limits — Use max_items_per_url to control volume (e.g., 20 items per page).
4. Enable error tolerance — Keep ignore_url_failures: true for reliable batch runs.
5. Execute the scraper — Start the run and monitor progress in the log.
6. Export & analyze — Download results as JSON, CSV, or Excel for recruitment workflows or analysis.

Best practices:

• Narrow searches by keyword or location to keep result sets manageable.
• Test with one URL before running large batches.
• Check that salary and grade data are populated for your target job category.

---

Use Cases & Business Value

• Federal recruitment analytics: Track which agencies are actively hiring and at what grade levels
• Compensation benchmarking: Monitor federal salary trends across departments and regions
• Job aggregation: Feed federal listings into multi-source job boards and career platforms
• Talent pool research: Identify emerging opportunities in government sectors
• Policy analysis: Analyze hiring patterns and workforce demand across government

The USAJobs Scraper eliminates manual data collection, delivering consistent, machine-readable records that integrate seamlessly into spreadsheets, applicant tracking systems, and business intelligence tools.

---

Conclusion

The USAJobs.gov Scraper is an efficient solution for anyone needing structured federal job data at scale. With detailed output across 21 fields and flexible search configuration, it transforms USAJobs search results into actionable intelligence for recruitment, analysis, and platform integration. Start a run today and unlock federal hiring insights.