FIfinancialdatasets
Macroeconomics

Labor Market (Historical)

Changed on

US labor market history for one series (the jobs report: nonfarm payrolls, unemployment rate, participation, hourly earnings; JOLTS job openings, hires, quits; weekly jobless claims), newest first, with the change from the prior period and from a year earlier. Dates are reference periods: the first day of the month for monthly series, the week-ending Saturday for weekly series. Values are in the series' units, sourced from authoritative government sources. A change is null when the comparison period was not published; change_year_pct is null for series measured in percent.

get/macro/labor

Request

  • Base URL
    https://api.financialdatasets.ai
  • Auth
    API key in header X-API-KEY

Query parameters

seriesstring required

The series id, e.g. payrolls_sa. Eight monthly concepts (payrolls, unemployment_rate, unemployment_rate_u6, participation_rate, hourly_earnings, job_openings, hires, quits) and five weekly ones (initial_claims, initial_claims_4_week, continued_claims, continued_claims_4_week, insured_unemployment_rate), each seasonally adjusted (_sa) and, except the 4-week averages, not (_nsa). Use the /macro/labor/series endpoint to get the list.

start_datestring

The first period to return, inclusive, in YYYY-MM-DD format; for a monthly series any day inside a month selects that month. Defaults to five years before end_date when both dates are omitted; omit it with an end_date to get all available history through that date.

end_datestring

The last period to return, inclusive, in YYYY-MM-DD format. Defaults to today.

cursorstring

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

Labor market response

next_page_urlstring

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.

Changes