Securely Redirecting...

Connecting to Stripe

Back to API Index

Job Openings (USD)

Total number of unfilled job positions, a key indicator of labor market demand and tightness.

Category: Labor Market

API Endpoint

/api/v1/announcements/usd/job_openings

Use the production OpenAPI schema for the authoritative REST route metadata.

https://fxmacrodata.com/api/openapi.json

Browse the full endpoint reference

Data Source

Primary Source

FRED (BEA/BLS/Fed)

Official Series ID

JTSJOL

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

Thousands

JSON Response Structure

The endpoint returns a chronological list of observations in JSON format. 

{
    "currency": "USD",
    "indicator": "job_openings",
    "has_official_forecast": false,
    "start_date": "2023-01-01",
    "end_date": "2023-12-31",
    "data": [
        {
            "date": "2024-07-01",
            "val": 4.2,
            "announcement_datetime": 1722456000
        }
    ]
}

Request Parameters & Usage

Parameter Required Format Description
start_date NO YYYY-MM-DD Optional lower bound for the requested history.
end_date NO YYYY-MM-DD Optional upper bound. Defaults to the current date.
api_key CONDITIONAL string Required for non-USD and paid access. USD endpoints are available free without an API key.

Example Usage

To retrieve the Job Openings data for USD starting from the beginning of 2023: 

GET https://fxmacrodata.com/api/v1/announcements/usd/job_openings?start_date=2023-01-01&end_date=2023-12-31&api_key=YOUR_API_KEY