{"uid":"cap_QelpVSpDJS3CtaLmTqQPJ","slug":"2s-io-e337d788","name":"2s.io BLS Time-Series Data API","description":"US Bureau of Labor Statistics time-series data. Pass seriesIds = comma-separated BLS series IDs (1-10 per call), optional startYear + endYear bracket (max 10 years). Each observation: year, period (M01-M12 monthly, Q01-Q04 quarterly, A01 annual, S01/S02 semiannual), periodName, value (verbatim string from BLS) + numericValue (parsed number), latest flag, footnote texts. Common series IDs: LNS14000000 (unemployment rate), CUUR0000SA0 (CPI-U all items), CES0000000001 (nonfarm employment), LNS11300000 (labor force participation). Unauthenticated upstream — ~25 queries/day per IP.","url":"https://2s.io/api/bls/series","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["seriesIds"],"properties":{"endYear":{"type":"integer","maximum":2100,"minimum":1900},"seriesIds":{"type":"string","description":"Comma-separated BLS series IDs."},"startYear":{"type":"integer","maximum":2100,"minimum":1900}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"seriesIds":"LNS14000000"}}},"response":{"data":{"ok":true,"meta":{"query":{"endYear":null,"seriesIds":["LNS14000000"],"startYear":null},"status":"REQUEST_SUCCEEDED"},"items":[{"catalog":null,"seriesId":"LNS14000000","observations":[{"year":"2026","value":"4.3","latest":true,"period":"M05","footnotes":[],"periodName":"May","numericValue":4.3},{"year":"2026","value":"4.3","latest":false,"period":"M04","footnotes":[],"periodName":"April","numericValue":4.3},{"year":"2026","value":"4.3","latest":false,"period":"M03","footnotes":[],"periodName":"March","numericValue":4.3},{"year":"2026","value":"4.4","latest":false,"period":"M02","footnotes":[],"periodName":"February","numericValue":4.4},{"year":"2026","value":"4.3","latest":false,"period":"M01","footnotes":["January 2026 estimates were revised to incorporate updated population controls. For more information, see www.bls.gov/cps/documentation.htm#pop."],"periodName":"January","numericValue":4.3},{"year":"2025","value":"4.4","latest":false,"period":"M12","footnotes":[],"periodName":"December","numericValue":4.4},{"year":"2025","value":"4.5","latest":false,"period":"M11","footnotes":[],"periodName":"November","numericValue":4.5},{"year":"2025","value":"-","latest":false,"period":"M10","footnotes":["Data unavailable due to the 2025 lapse in appropriations."],"periodName":"October","numericValue":null},{"year":"2025","value":"4.4","latest":false,"period":"M09","footnotes":[],"periodName":"September","numericValue":4.4},{"year":"2025","value":"4.3","latest":false,"period":"M08","footnotes":[],"periodName":"August","numericValue":4.3},{"year":"2025","value":"4.3","latest":false,"period":"M07","footnotes":[],"periodName":"July","numericValue":4.3},{"year":"2025","value":"4.1","latest":false,"period":"M06","footnotes":[],"periodName":"June","numericValue":4.1},{"year":"2025","value":"4.3","latest":false,"period":"M05","footnotes":[],"periodName":"May","numericValue":4.3},{"year":"2025","value":"4.2","latest":false,"period":"M04","footnotes":[],"periodName":"April","numericValue":4.2},{"year":"2025","value":"4.2","latest":false,"period":"M03","footnotes":[],"periodName":"March","numericValue":4.2},{"year":"2025","value":"4.2","latest":false,"period":"M02","footnotes":[],"periodName":"February","numericValue":4.2},{"year":"2025","value":"4.0","latest":false,"period":"M01","footnotes":[],"periodName":"January","numericValue":4},{"year":"2024","value":"4.1","latest":false,"period":"M12","footnotes":[],"periodName":"December","numericValue":4.1},{"year":"2024","value":"4.2","latest":false,"period":"M11","footnotes":[],"periodName":"November","numericValue":4.2},{"year":"2024","value":"4.1","latest":false,"period":"M10","footnotes":[],"periodName":"October","numericValue":4.1},{"year":"2024","value":"4.1","latest":false,"period":"M09","footnotes":[],"periodName":"September","numericValue":4.1},{"year":"2024","value":"4.2","latest":false,"period":"M08","footnotes":[],"periodName":"August","numericValue":4.2},{"year":"2024","value":"4.2","latest":false,"period":"M07","footnotes":[],"periodName":"July","numericValue":4.2},{"year":"2024","value":"4.1","latest":false,"period":"M06","footnotes":[],"periodName":"June","numericValue":4.1},{"year":"2024","value":"3.9","latest":false,"period":"M05","footnotes":[],"periodName":"May","numericValue":3.9},{"year":"2024","value":"3.9","latest":false,"period":"M04","footnotes":[],"periodName":"April","numericValue":3.9},{"year":"2024","value":"3.9","latest":false,"period":"M03","footnotes":[],"periodName":"March","numericValue":3.9},{"year":"2024","value":"3.9","latest":false,"period":"M02","footnotes":[],"periodName":"February","numericValue":3.9},{"year":"2024","value":"3.7","latest":false,"period":"M01","footnotes":[],"periodName":"January","numericValue":3.7}]}],"total":1,"source":{"url":"https://www.bls.gov/developers/","license":"Public domain (US government work)","provider":"US Bureau of Labor Statistics — Public Data API"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"bls.series","settlement":{"txHash":"0xefc53cf84777ed29e2009e6ba08a5c9f5ad37e39d823abd0b3cb1f31d30cd425","network":"eip155:8453","success":true}}}},"exampleRequest":{"seriesIds":"LNS14000000"},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_F-HxrXO89lxmc4V1Uhjdu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches US Bureau of Labor Statistics time-series observations for up to 10 BLS series IDs, with optional year range filtering","exampleAgentPrompt":"Pull me the monthly unemployment rate (LNS14000000) and CPI-U all items (CUUR0000SA0) from BLS for 2020 through 2024 so I can compare inflation and joblessness trends over those five years.","exampleUseCases":null,"resultDescription":"An array of observations per series ID, each containing year, period code (e.g. M01-M12, Q01-Q04, A01), period name, verbatim BLS value string, parsed numeric value, a flag indicating if it is the latest data point, and any associated footnote texts.","failureModes":["Invalid or unrecognized BLS series ID returns empty or error response","Year range exceeding 10 years may be rejected or truncated","More than 10 series IDs in a single call exceeds the limit","Rate limit of ~25 queries/day per IP from unauthenticated BLS upstream","Network timeout if BLS upstream is slow or unavailable","Non-existent series ID silently returns no observations"],"whenToPreferThis":"Use this endpoint when you need structured BLS economic time-series data — unemployment, CPI, employment, labor force participation — without a BLS API key or direct BLS integration. Ideal for quick lookups of standard macro indicators. Prefer over raw BLS API when you want a clean parsed numeric value alongside the verbatim BLS string and footnotes, within a 10-series / 10-year call. Not suitable for bulk historical pulls beyond 10 years or more than 10 series per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:15.393Z","isFirstParty":false}