{"uid":"cap_gEQ0EFwAl_nQ77Rf0BWoa","slug":"2s-io-eeb9bb49","name":"World Bank Indicator Time Series","description":"World Bank Open Data — fetch a time series of a specific indicator for a country (or 'all'). 1000+ indicators across 200+ countries, many series going back to 1960. Indicator codes are dotted-token strings, e.g., NY.GDP.MKTP.CD (GDP current US$), SP.POP.TOTL (population total), FP.CPI.TOTL.ZG (inflation CPI annual %), SL.UEM.TOTL.ZS (unemployment %), SE.ADT.LITR.ZS (adult literacy %), SP.DYN.LE00.IN (life expectancy). Country = ISO 2-letter (e.g., US, CN), ISO 3-letter (USA, CHN), or 'all'. Optional yearFrom/yearTo bracket. Each observation: country id+name, year, numeric value (may be null for missing), obsStatus. Returns indicator name + total count + pagination metadata.","url":"https://2s.io/api/worldbank/indicator","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":["country","indicator"],"properties":{"page":{"type":"integer","default":1,"minimum":1},"limit":{"type":"integer","default":50,"maximum":100,"minimum":1},"yearTo":{"type":"integer","maximum":2100,"minimum":1960},"country":{"type":"string","description":"ISO 2/3-letter country code or 'all'."},"yearFrom":{"type":"integer","maximum":2100,"minimum":1960},"indicator":{"type":"string","description":"World Bank indicator code, e.g., NY.GDP.MKTP.CD."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"page":1,"limit":50,"yearTo":2023,"country":"US","yearFrom":1990,"indicator":"NY.GDP.MKTP.CD"}}},"response":{"data":{"ok":true,"meta":{"query":{"page":1,"limit":50,"yearTo":2023,"country":"US","yearFrom":1990,"indicator":"NY.GDP.MKTP.CD"},"indicatorId":"NY.GDP.MKTP.CD","lastUpdated":"2026-04-08","indicatorName":"GDP (current US$)"},"page":{"size":50,"pages":1,"number":1},"items":[{"year":2023,"value":27292170793214.4,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2022,"value":25604848907611,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2021,"value":23315080560000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2020,"value":21060473613000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2019,"value":21380976119000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2018,"value":20533057312000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2017,"value":19477336549000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2016,"value":18695110842000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2015,"value":18206020741000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2014,"value":17550680174000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2013,"value":16843190993000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2012,"value":16253972230000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2011,"value":15599728123000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2010,"value":15048964444000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2009,"value":14478064934000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2008,"value":14769857911000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2007,"value":14474226905000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2006,"value":13815586948000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2005,"value":13039199193000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2004,"value":12217193198000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2003,"value":11456442041000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2002,"value":10929112955000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2001,"value":10581929774000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":2000,"value":10250947997000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1999,"value":9631174489000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1998,"value":9062818202000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1997,"value":8577554457000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1996,"value":8073122000000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1995,"value":7639749000000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1994,"value":7287236000000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1993,"value":6858559000000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1992,"value":6520327000000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1991,"value":6158129000000,"countryId":"US","obsStatus":null,"countryName":"United States"},{"year":1990,"value":5963144000000,"countryId":"US","obsStatus":null,"countryName":"United States"}],"total":34,"source":{"url":"https://data.worldbank.org/","license":"CC BY 4.0 (World Bank)","provider":"World Bank Open Data"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"worldbank.indicator","settlement":{"txHash":"0x6def4f816801ea8fd0055c3d84a9ed20845ce9fa932a3cdb49c20a6d182ecd55","network":"eip155:8453","success":true}}}},"exampleRequest":{"page":1,"limit":50,"yearTo":2023,"country":"US","yearFrom":1990,"indicator":"NY.GDP.MKTP.CD"},"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_8cfhC6W-H1v0MhPHKCkds","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 a paginated time series of any World Bank indicator (GDP, population, inflation, etc.) for one country or all countries, with optional year range filtering.","exampleAgentPrompt":"Can you pull the World Bank time series for GDP in current US dollars (indicator NY.GDP.MKTP.CD) for the United States from 1990 to 2023?","exampleUseCases":null,"resultDescription":"Returns an array of annual observations each containing country id and name, year, and numeric value (possibly null for missing data), plus the indicator's display name, total observation count, and pagination metadata (page, limit, total pages).","failureModes":["Invalid or unknown indicator code returns empty results or error","Invalid country code returns 400 or empty dataset","Year range outside supported bounds (pre-1960) returns validation error","Data missing for requested years returns null values in observations","Network timeout or upstream World Bank API unavailability returns 5xx","Page number beyond total pages returns empty results array"],"whenToPreferThis":"Use this endpoint when you need structured, historical time-series data from the World Bank for macroeconomic, demographic, or development indicators across one or all countries. Prefer this over general web search when you need precise numeric values, multi-decade trends, or programmatically usable structured data rather than narrative summaries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:56:27.080Z","isFirstParty":false}