# USAJOBS, free: Job posting details API

> The Announcement Text API is designed to deliver long text fields for all current and past job postings to USAJOBS filtered by a set of standard parameters. This endpoint is intended to deliver a bulk data set to be parsed by the consumer.

USAJOBS's job posting details API on its No API key plan. It costs $0.00 per 1,000 jobs. It returns 3 of the 13 key fields we check: Description, Category, Level.
We haven't run USAJOBS through [our job posting details API benchmark](https://datacircle.dev/best-job-posting-details-api.txt) yet.
Half of the 250 plans we rank by price cost $1.125 per 1,000 jobs or less. This plan and 20 others tie for the lowest price per 1,000 jobs of the 250 plans.
[Greenhouse](https://datacircle.dev/job-posting-details-apis/greenhouse/free/llms.txt), [Lever](https://datacircle.dev/job-posting-details-apis/lever/free/llms.txt) and [Recruitee](https://datacircle.dev/job-posting-details-apis/recruitee/free/llms.txt) are the best job posting details API providers in our benchmark.

- This page: https://datacircle.dev/job-posting-details-apis/usajobs/free
- [Job posting details API: 18 providers compared](https://datacircle.dev/best-job-posting-details-api.txt)
- Get it: https://developer.usajobs.gov/api-reference/get-api-announcementtext?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- Request: `GET https://data.usajobs.gov/api/historicjoa/announcementtext`
- API key: not needed
- Its API docs: https://developer.usajobs.gov/api-reference/get-api-announcementtext?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- Sold by: USAJOBS (https://developer.usajobs.gov?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing)
- Checked: 2026-11-04

## In the answer

- Completeness: 23%
- Description: ✓
- Category: ✓
- Level: ✓

## Price

- $ per 1,000 jobs: $0.00
- Per: call
- Billing: free

## Aggregators

- Aggregators: none

## Not found

- $ per 1,000: $0.00

## In their words

- Their pitch: The Announcement Text API is designed to deliver long text fields for all current and past job postings to USAJOBS filtered by a set of standard parameters. This endpoint is intended to deliver a bulk data set to be parsed by the consumer.

## Data

- History: no limit
- Keep data: no limit
- Use data: Public Data may be copied, stored, reformatted, adapted, analyzed, published, redistributed, and used for lawful commercial or noncommercial purposes. Prior OPM approval is not required. [...] OPM encourages users to identify USAJOBS as the source, link to the current official job announcement, include the date on which the data was retrieved, and disclose that an unofficial product or service is not operated, sponsored, approved, or endorsed by OPM. [...] API Consumers and downstream users may modify, summarize, analyze, or combine Public Data but may not: Falsely present modified information as official or unaltered government information, Falsely represent that a product or service is operated, sponsored, approved, or endorsed by OPM or another federal agency, Use an official seal, logo, or insignia except as authorized by law, or otherwise use an agency name or identifier in a manner likely to falsely imply government affiliation, Falsely represent that an application has been transmitted to or received by USAJOBS or a hiring agency, or Engage in phishing, fraud, deceptive collection of applicant information, or other unlawful conduct.

## Plan

- Pay: $0

## Speed

- Answer: in the call

## The call

- You send: nothing required. Optional: HiringAgencyCodes, HiringDepartmentCodes, PositionSeries, AnnouncementNumbers, USAJOBSControlNumbers, StartPositionOpenDate, EndPositionOpenDate, StartPositionCloseDate, EndPositionCloseDate, continuationtoken
- Method: GET
- Path: /api/historicjoa/announcementtext

## About the plan

- Plan: No API key
- Who can get it: anyone

## The 31 fields the plan's answer can hold

job ID, announcement number, open date, close date, hiring agency code, hiring department code, job categories, summary, duties, hiring path explanation, major duties list, conditions of employment, qualifications, education requirements, required standard documents, required documents, how to apply, next steps, requirements, evaluations, benefits URL, benefits, other information, appointment type override, position schedule override, exclusive clarification text, video URL, total results, page size, continuation token, next page link

## USAJOBS's plans (1)

- [USAJOBS, free](https://datacircle.dev/job-posting-details-apis/usajobs/free/llms.txt): $0.00 per 1,000, 23% complete

## USAJOBS's calls for this API (1)

- `GET /api/historicjoa/announcementtext`: [USAJOBS, free](https://datacircle.dev/job-posting-details-apis/usajobs/free/llms.txt)

## USAJOBS's APIs (2)

- [USAJOBS: job postings API pricing, 2 plans](https://datacircle.dev/job-posting-apis/usajobs/free-api-key/llms.txt)
- [USAJOBS: job posting details API pricing, 1 plan](https://datacircle.dev/job-posting-details-apis/usajobs/free/llms.txt)

## USAJOBS: job posting details API alternatives

- [Greenhouse, free](https://datacircle.dev/job-posting-details-apis/greenhouse/free/llms.txt): $0.00 per 1,000, 77% complete, live
- [Lever, free](https://datacircle.dev/job-posting-details-apis/lever/free/llms.txt): $0.00 per 1,000, 54% complete, live
- [Recruitee, free](https://datacircle.dev/job-posting-details-apis/recruitee/free/llms.txt): $0.00 per 1,000, 92% complete, live
- [freehire, free](https://datacircle.dev/job-posting-details-apis/freehire/free/llms.txt): $0.00 per 1,000, 85% complete, stored
- [Reed, free](https://datacircle.dev/job-posting-details-apis/reed/free/llms.txt): $0.00 per 1,000, 38% complete

## Sources

From each provider's own pricing page and docs, and from what providers tell us. We read this row from these pages on 2026-11-04.

- https://data.usajobs.gov/api/historicjoa/announcementtext?HiringAgencyCodes=VALA&StartPositionOpenDate=2026-01-01&EndPositionOpenDate=2026-09-30&utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://data.usajobs.gov/api/historicjoa/announcementtext?USAJOBSControlNumbers=854068900&utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://developer.usajobs.gov/?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://developer.usajobs.gov/api-reference/get-api-announcementtext?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://developer.usajobs.gov/api-reference/job-apis?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://developer.usajobs.gov/guides/rate-limiting?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://developer.usajobs.gov/guides/terms-of-service?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing
- https://developer.usajobs.gov/tutorials/past-job-announcements?utm_source=datacircle.dev&utm_medium=referral&utm_campaign=job-posting-details-api-pricing