USA Jobs Scraper

Collect federal job listings from USAJobs.gov quickly and reliably. Extract comprehensive records including titles, agencies, salary ranges, application windows, and full job descriptions in one run. Perfect for workforce monitoring, hiring intelligence, and research workflows.

---

Features

• Comprehensive job records - Collect position metadata, agency details, compensation, and application links.
• Flexible search controls - Filter by keyword, location, search URL, and recency window.
• Pagination at scale - Gather large result sets efficiently with adjustable collection limits.
• Structured descriptions - Receive both rich description content and plain-text versions for analysis.
• Production-ready outputs - Export clean datasets for analytics, automation, and reporting.

---

Use Cases

Labor Market Intelligence

Track hiring activity across federal agencies and departments to identify growth patterns, role demand, and regional opportunities.

Job Board Aggregation

Enrich job platforms with federal opportunities and keep listings updated with structured, machine-readable data.

Salary Benchmarking

Analyze compensation ranges by role, agency, and location to build benchmarking dashboards and market reports.

Public Sector Research

Build datasets for policy studies, workforce planning, and long-term hiring trend analysis.

Career Services

Help candidates discover relevant opportunities with detailed descriptions, open/close dates, and direct application links.

---

Input Parameters

Parameter	Type	Required	Default	Description
searchUrl	String	No	-	USAJobs search URL. If provided, keyword and location can be parsed automatically.
keyword	String	No	-	Search keyword such as job title or skill.
location	String	No	-	Location filter such as city, state, or region.
daysBack	Integer	No	30	Recency filter for posted jobs (1-60 days).
includeClosed	Boolean	No	false	Include jobs that are no longer accepting applications.
maxJobs	Integer	No	1000	Maximum number of jobs to collect.
proxyConfiguration	Object	No	{"useApifyProxy": false}	Proxy settings for request routing and reliability.

---

Output Data

Each dataset item contains:

Field	Type	Description
source	String	Source identifier.
controlNumber	String	USAJobs control number for the listing.
positionId	String	Position ID from the listing metadata.
positionTitle	String	Official job title.
organizationName	String	Hiring organization.
departmentName	String	Parent department name.
subAgencyName	String	Sub-agency where available.
locationDisplay	String	Display-friendly location string.
positionLocations	Array	Raw location objects from listing metadata.
positionOpenDate	String	Posting start date.
positionCloseDate	String	Posting close date.
open_close_dates	String	Combined open/close date string.
detailUrl	String	URL of the detailed listing page.
applyUrl	String	Direct application URL when available.
minimumSalary	Number	Minimum salary value.
maximumSalary	Number	Maximum salary value.
salary	String	Human-readable salary range.
payGrade	String	Pay grade range.
pay_scale_grade	String	Alternate pay grade field for compatibility.
workSchedule	String	Work schedule label.
work_schedule	String	Alternate work schedule field for compatibility.
appointmentType	String	Appointment type label.
appointment_type	String	Alternate appointment field for compatibility.
whoMayApply	String	Candidate eligibility category.
service	String	Service type where provided.
promotion_potential	String	Promotion potential value.
securityClearance	String	Security clearance information.
security_clearance	String	Alternate security clearance field for compatibility.
supervisory_status	String	Supervisory status where available.
telework_eligible	String	Telework eligibility information.
travel_required	String	Travel requirement information.
jobCategories	Array	Job category codes and names.
description_html	String	Structured description content.
description_text	String	Plain-text description content.

---

Usage Examples

Basic Search

{
  "keyword": "data analyst",
  "location": "Washington, DC",
  "maxJobs": 50
}

Search URL Driven Collection

{
  "searchUrl": "https://www.usajobs.gov/Search/Results?k=cybersecurity&l=Texas",
  "daysBack": 14,
  "maxJobs": 100
}

Broad Monitoring Run

{
  "keyword": "program manager",
  "daysBack": 30,
  "includeClosed": false,
  "maxJobs": 500
}

---

Sample Output

{
  "source": "usajobs",
  "controlNumber": "826008100",
  "positionId": "ABCD-1234",
  "positionTitle": "IT Specialist (Application Software)",
  "organizationName": "Department of Veterans Affairs",
  "departmentName": "Department of Veterans Affairs",
  "subAgencyName": "Office of Information and Technology",
  "locationDisplay": "Washington, District of Columbia",
  "positionOpenDate": "2026-03-01T00:00:00Z",
  "positionCloseDate": "2026-04-01T23:59:59Z",
  "open_close_dates": "2026-03-01T00:00:00Z - 2026-04-01T23:59:59Z",
  "detailUrl": "https://www.usajobs.gov/job/826008100",
  "applyUrl": "https://www.usajobs.gov/job/826008100/apply",
  "minimumSalary": 112015,
  "maximumSalary": 145617,
  "salary": "$112,015 - $145,617 Per Year",
  "payGrade": "13-13",
  "workSchedule": "Full-time",
  "appointmentType": "Permanent",
  "whoMayApply": "Public",
  "securityClearance": "Not Required",
  "telework_eligible": "Yes",
  "travel_required": "Occasional travel",
  "description_text": "Summary Duties Qualifications Education How To Apply ..."
}

---

Tips for Best Results

Start Narrow, Then Expand

• Begin with targeted keywords and one location to validate output quality.
• Expand to broader terms and larger job limits after verification.

Tune Recency for Fresh Results

• Use lower daysBack values to focus on newly posted opportunities.
• Use higher values when building historical or comparative datasets.

Control Volume with maxJobs

• Use small limits for quick checks.
• Increase gradually for production collection runs.

Use Reliable Proxy Settings

• Enable proxy routing when running larger collections.
• Residential proxy pools typically improve consistency for repeated runs.

---

Integrations

• Google Sheets - Share and analyze collected jobs collaboratively.
• Airtable - Build searchable databases for recruiting and research teams.
• Slack - Send notifications when new runs finish.
• Webhooks - Push results into custom systems automatically.
• Make - Build no-code workflows around collection and reporting.
• Zapier - Connect results to downstream apps and automations.

Export Formats

• JSON - Developer-friendly structured data.
• CSV - Spreadsheet and BI tool compatibility.
• Excel - Reporting and analyst workflows.
• XML - Legacy system integration support.

---

Frequently Asked Questions

How many jobs can I collect in one run?

You can collect up to the value set in maxJobs, limited by available search results.

Can I collect jobs without a keyword?

Yes. You can run with location only, or use a search URL to define filters.

Why are some fields empty?

Some listings do not provide every field. Empty values reflect source availability.

Can I include closed listings?

Yes. Set includeClosed to true to include closed positions.

Can I automate recurring collection?

Yes. Schedule recurring runs from the Apify Console to track changes over time.

---

Support

For issues or feature requests, contact support through the Apify Console.

Resources

• Apify Documentation
• API Reference
• Scheduling Runs

---

Legal Notice

This actor is intended for legitimate data collection. Users are responsible for compliance with applicable laws, platform rules, and usage policies.