{"openapi":"3.1.1","info":{"title":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: The unemployment rate, number unemployed, employed and labor force for every county and state, from the Bureau of Labor Statistics' Local Area Unemployment Statistics (LAUS) program: the annual average for each year 2015 to 2025 and the latest 13 months. Each county and state record carries the latest annual average, the change from the year before and since 2015, and the latest month (preliminary until BLS revises it). County figures are model-based estimates that BLS controls to its state totals; the build checks that county employment, unemployment and labor force add up to the state's. Retired Alaska census-area codes with no current estimate are left out, and Connecticut appears as BLS publishes it.\n\nProbative is a marketing firm, not a law firm; not legal advice. Every JSON response starts with a \"meta\" object holding the credit line, citation, DOI and license (CC BY 4.0).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"Probative Growth","url":"https://probativegrowth.com/contact/","email":"hello@probativegrowth.com"}},"servers":[{"url":"https://probativegrowth.com"}],"externalDocs":{"description":"How to use the API and the MCP server","url":"https://probativegrowth.com/resources/rules-api/"},"paths":{"/data/v1/unemployment/index.json":{"get":{"summary":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: index","description":"unemployment: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["unemployment"]}},"/data/v1/unemployment/changes.json":{"get":{"summary":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: confirmed changes","description":"unemployment: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["unemployment"]}},"/data/v1/unemployment/jurisdictions/{key}.json":{"get":{"summary":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: one jurisdiction","description":"unemployment: the records for one jurisdiction","parameters":[{"name":"key","in":"path","required":true,"description":"The jurisdiction key, uppercase","schema":{"type":"string"}}],"responses":{"200":{"description":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["unemployment"]}},"/data/v1/unemployment/unemployment.csv":{"get":{"summary":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month as CSV","description":"unemployment: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["unemployment"]}},"/data/v1/unemployment/unemployment.json":{"get":{"summary":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: every record","description":"unemployment: every record in one file","parameters":[],"responses":{"200":{"description":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["unemployment"]}},"/data/v1/unemployment/search.json":{"get":{"summary":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: keyword index","description":"unemployment: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"County and state unemployment: BLS Local Area Unemployment Statistics, annual averages and latest month: keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["unemployment"]}},"/data/v1/unemployment/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"unemployment: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["unemployment"]}}},"components":{"schemas":{"Meta":{"type":"object","description":"Credit line, citation, DOI, version, license and disclaimer. Present in every response.","required":["dataset","version","license","attribution","disclaimer","url"],"properties":{"dataset":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"doi":{"type":["string","null"]},"doiUrl":{"type":["string","null"]},"conceptDoi":{"type":["string","null"]},"license":{"type":"string","const":"CC BY 4.0"},"licenseUrl":{"type":"string"},"attribution":{"type":"string"},"citation":{"type":"string"},"disclaimer":{"type":"string"},"notice":{"type":"string"},"lastChecked":{"type":"string"},"url":{"type":"string"},"humanUrl":{"type":"string"},"statusCodes":{"type":"object"}}},"Envelope":{"type":"object","required":["meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"}},"additionalProperties":true}}}}