Financial Datasets — Labor Market (Historical)
financialdatasets_get_macro_laborUS 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. Uses the caller's OpenAny gateway credentials. Charges and authorization are determined by the gateway.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | 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. | |
| series | Yes | 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. | |
| end_date | No | The last period to return, inclusive, in YYYY-MM-DD format. Defaults to today. | |
| start_date | No | 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. |