USAJOBS API

Beginner's Pick Jobs / API Key Intermediate HTTPS

72 B

Metadata Score Metadata estimate · not endpoint-tested

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

The kind of data this API exposes, based on its documentation. We could not call the endpoint to confirm the exact field names.

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

USAJOBS data via REST API

Example Response

Illustrative shape only — we were not able to call this endpoint (it requires credentials or exposes no public sample URL), so the fields below show the kind of data this API returns rather than a recorded response.

JSON Response · Illustrative

{
  "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

Calls a real endpoint of this API. Replace any placeholder credentials with your own key.

Request

const url = "https://data.usajobs.gov/api/search?Keyword=software+engineer&LocationName=Washington%2C+DC&ResultsPerPage=10";
// 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);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

Generated guidance based on this API's documentation, not observed by us. Treat it as a starting point and check against the provider's own error reference.

401 Unauthorized Missing or mismatched API key or User-Agent email header.

✓ Include both the Authorization-Key header with your API key and the User-Agent header with your registered email address.

400 Bad Request Invalid parameter names or values in the query string.

✓ Refer to the USAJOBS API documentation for exact parameter names such as Keyword (capitalized), not keyword.

Empty SearchResult array No jobs match the combined filters such as a very specific agency plus rare keyword.

✓ Remove some filters to broaden the search, or check that agency abbreviations match USAJOBS codes.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →