BLS Public Data API
The BLS Public Data API is the agency's public REST + JSON service for retrieving published historical time series across every BLS program. v1 is open and unauthenticated with smaller daily limits and per-request caps; v2 requires a free registration key and unlocks 500 queries per day, up to 50 series per request, up to 20 years per query, optional catalog metadata, net/percent-change calculations, and annual averages. All requests return a uniform JSON envelope with status, responseTime, and Results.series, where each series carries data points keyed by year and period (M01–M12 for monthly, Q01–Q04 for quarterly, S01–S03 for semi annual, A01 for annual, M13 for annual averages).
Documentation
Documentation
https://www.bls.gov/developers/home.htm
Documentation
https://www.bls.gov/developers/api_signature_v2.htm
GettingStarted
https://www.bls.gov/developers/api_FAQs.htm
RateLimits
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/rate-limits/bls-gov-rate-limits.yml
Specifications
Schemas & Data
JSONSchema
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/json-schema/bls-time-series-schema.json
JSONStructure
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/json-structure/bls-time-series-structure.json
Other Resources
Registration
https://data.bls.gov/registrationEngine/
TermsOfService
https://www.bls.gov/developers/termsOfService.htm
SignatureExamples
https://www.bls.gov/developers/api_sample_code.htm
JSONLD
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/json-ld/bls-gov-context.jsonld
SpectralRuleset
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/rules/bls-public-data-api-rules.yml
DataAPI
https://api.bls.gov/publicAPI/v2/timeseries/data/
DataAPI
https://api.bls.gov/publicAPI/v2/surveys
DataAPI
https://api.bls.gov/publicAPI/v2/timeseries/popular
Plans
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/plans/bls-gov-plans-pricing.yml
FinOps
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/finops/bls-gov-finops.yml
Examples
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/examples/bls-get-unemployment-rate-example.json
Examples
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/examples/bls-list-surveys-example.json
Vocabulary
https://raw.githubusercontent.com/api-evangelist/bls-gov/refs/heads/main/vocabulary/bls-gov-vocabulary.yml