Job APIs

This reference covers the Search, Historic JOAs, and Announcement Text APIs.

The base URL for the Job APIs is: https://data.usajobs.gov.

Authentication

The search jobs require authentication using an API Key provided by USAJOBS after submitting the API Request form.

Pagination

The search jobs API has the potential to return a large array of objects.

The API will leverage paging to return the results in groups of 250 JOAs per page by default. This can be adjusted by passing the parameter "ResultsPerPage" with a number up to 500. Specific pages are retrieved by passing the parameter "Page" with the number of the paged result desired. The following example would return page three containing 50 results (i.e. results 151 - 200).

https://data.usajobs.gov/api/Search?Page=3&ResultsPerPage=50

Job API Endpoints

The job APIs below use the GET HTTP request method.