USAJOBS API

⭐ Beginner's Pick Jobs / API Key Intermediate HTTPS

Varies by plan (check documentation)

72 Score

Grade B

Visit Official Site Compare Alternatives

Overview

USAJOBS is the official US federal government job portal, and its API provides programmatic access to thousands of government job listings. Developers can search openings by keyword, location, agency, and pay grade to build specialized job search tools. Authentication uses an API key passed in the request header alongside your registered email address.

💡

Beginner Tip

USAJOBS requires both your API key and the email address used during registration as request headers—omitting either will result in a 401 error. Register at developer.usajobs.gov to get your credentials before making any calls.

Available Data

Use case: Integrate us government job board data into web and mobile applications

USAJOBS data via REST API

JSON-formatted response data

Requires API key authentication

Example Response

JSON Response

{
  "title": "Software Engineer",
  "company": "Tech Corp",
  "location": "Remote",
  "salary_range": "$120,000 - $180,000",
  "posted_date": "2025-01-10",
  "description": "We are looking for an experienced..."
}

Field Reference

SearchResult.SearchResultItems List of job announcement objects matching the search criteria.

MatchedObjectDescriptor.PositionTitle Official job title of the federal position.

MatchedObjectDescriptor.DepartmentName Name of the federal department or agency posting the job.

MatchedObjectDescriptor.PositionLocationDisplay Human-readable location of the position.

MatchedObjectDescriptor.PositionRemuneration Salary range details including minimum and maximum annual pay.

MatchedObjectDescriptor.ApplicationCloseDate Date and time when the application window closes in ISO 8601 format.

Implementation Example

const url = "https://developer.usajobs.gov/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);