get_market_latest | /api/v1/markets/latest | Latest monthly market observations. Latest published months of OECD equity indices and bond rates, Fed yields, Shiller CAPE, prices, earnings and dividends. Each measure has its own date, source, quality, same-month annual comparison and December 2022 baseline; missing endpoints are not filled and comparisons do not cross methodology breaks B. Not live quotes. |
get_market_cycles | /api/v1/markets/cycles | Market drawdowns and recoveries. Precomputed falls of at least 20%: monthly OECD equities (WDI annual archive fallback) and quarterly real BIS housing prices. Peaks, troughs, depth, recovery and censored episodes. Annual sampling misses intrayear crashes; missing data are not recovery. Price episodes, not banking-crisis dates or bubble diagnoses. |
list_datasets | /api/v1/datasets | Market, society, internet and cryptoasset datasets. Matched count/observations are before limit; catalog_datasets/catalog_observations describe the complete registry. Typed datasets: markets (WDI capitalisation/trading, monthly Federal Reserve H.15 yields, quarterly BIS housing, monthly OECD indices and Shiller CAPE, 164 banking episodes from IMF 2026; quoted yields are not portfolio returns), internet restrictions (Access Now STOP cases, affected territories, reporting years and unknown flags) and Freedom House expert scores; cryptoassets (Coin Metrics prices, capitalization, supply, spot volume, addresses and transactions; Federal Reserve/ECB/FCA ownership and use surveys; independent growthepie chain metrics, selected Curve/Uniswap pools from primary APIs/blockchain), religious composition, census communities, beliefs and practices, switching, migrant religion and restrictions; WVS/EVS with distinct denominators, historical Christian denominations and Muslim traditions; digital consumption (Statcounter search/AI referrals, Eurostat/CNNIC/Pew/NTIA/Cetic/Ofcom surveys, skills and AI by group, teens and parents, news and media literacy, TikTok/Snapchat DSA audiences, WeChat/QQ accounts), libraries, time use, communities, pets, COVID, software, science, food, land, climate, companies and games; education tests (PISA, TIMSS, PIRLS, PIAAC with standard errors and comparability flags); education and work (NY Fed recent-graduate unemployment, underemployment and wages, BLS monthly unemployment 25+ by attainment, Eurostat unemployment and employment by age and ISCED, OECD Education at a Glance with standard errors and relative earnings, ILOSTAT national surveys for all countries — not modelled estimates). Includes entity types, periods, licenses and primary sources. People, referrals, accounts and hours have distinct definitions; monthly and annual aggregates must not be added. Addresses are not people; volume is not net inflow; Coin Metrics uses CC BY-NC 4.0. |
get_dataset | /api/v1/datasets/{dataset} | Dataset observations and provenance. One bounded page (up to 100 rows), original units, entity type/id, period, time basis, JSON dimensions, quality flags, primary-source URL and raw-file SHA256. Includes next-page and complete CSV links. Inequalities in dimensions.operator remain bounds, not exact observations. For cryptoassets, month_end is an end-of-month stock, calendar_month is a sum/mean per dimensions.aggregation, and last_complete_day retains each metric’s own date. dated_snapshot is a Curve reserve snapshot with source timestamp/block in dimensions. Independent growthepie data uses CC BY 4.0; selected pools are not DeFi totals and USDC/WETH are not USD. Gaps are not filled; the token selection is not the entire market. Religion datasets distinguish affiliation, belief and practice; nested census groups must not be summed, and periods and denominators are retained. |
search_locations | /api/v1/locations | Find a country or region. Finds countries and regions by name or code and returns the codes used by other calls. |
get_insights | /api/v1/insights | What the data shows. The main tool for "why", "what is related", "how wrong were forecasts", "where is it heading": ready observations with numbers — trend breaks and thresholds, what changed at the same time, relationships in levels and year-to-year changes, the position among countries with the same income, which milestones usually come first across countries, past UN and IMF forecast errors and the current outlook; a comparison for several countries; view_url opens the same view on the site. |
get_popular_findings | /api/v1/findings/popular | What people find interesting. неинтересно». sort=interesting — что интересно большинству, divisive — где мнения разделились, unrated — ещё без отметок. Можно отфильтровать по стране и теме. У каждой — ссылка на страницу карточки (card: /c/<slug>/, с картинкой превью для мессенджеров; открывает ленту на ней), короткая ссылка для соцсетей (short_url: /<код> из 3 знаков, 301 на страницу карточки на языке читателя) и тот же вид графика. / Findings from the feed (two numbers on one scale and the year one overtook the other, forecast errors, records and more) with anonymous counts of visitors' "interesting / not interesting" votes: what most people find interesting, where opinions split, what is unrated; filter by country or topic; each links to the card's own page (card: /c/<slug>/, with a preview picture), its short link for social networks (short_url: /<code> of 3 signs, a 301 to the card's page in the reader's language) and the same view of the chart. |
list_collections | /api/v1/collections | Collections of cards. Collections of the feed: a question, the cards that answer it in order, and a conclusion with key numbers and sources. kind=chain (each card answers the previous one's question) or build (facts from different fields meet in one conclusion); author=editorial. Each has a page (url: /s/<slug>/, the feed opened on it) and a short link (short_url). The whole of one: get_collection. |
get_collection | /api/v1/collections/{collection} | One collection of cards. One collection by id (col:…), page slug in either language or short code: the question, the lead, the steps — the cards in order (headline, text, source, links to the card's page, short link and chart) with the notes between them — and the conclusion: title, text, key numbers (each with the card it comes from) and primary sources. |
get_user_profile | /api/v1/users/{handle} | A person's profile. The public part of a person's profile by handle: name, handle, initials, a few words, the month they joined, the link to their page (/en/u/<handle>/), followers and following counts, their public collections (up to 20, never drafts, with status) and what they marked as important (up to 50, newest first, with their note and the card's link). Email, votes and reading are never disclosed. No key needed. |
list_user_collections | /api/v1/users/{handle}/collections | A person's collections. Public collections of cards made by the person with this handle, newest first: question, kind, cards in order with their notes, the author's conclusion, the page link (/en/u/<handle>/s/<id>/) and status — published (by link and to followers), review (with the editors), approved (accepted by the editors: only these come into the general feed), rejected. Drafts are never shown. The editors' collections: list_collections. No key needed. |
suggest_research | /api/v1/suggestions/research | Suggest a research question. Suggest a research question or direction to the editors: what to check in the data and why, with links. Needs a personal key (Authorization: Bearer mk_…, issued in the feed's «Profile» card to an account with a handle). It goes to the editors' queue, nothing reaches the site by itself; returns the id and status new; the decision and reply: my_suggestions. Записи: не больше 60 в минуту с одного адреса, у аккаунта первых суток лимиты ниже; ключ заблокированного редакцией профиля — ошибка 403 blocked. / Writes: at most 60 a minute from one address, lower limits for an account in its first day; a key of a profile the editors blocked is a 403 blocked. |
suggest_source | /api/v1/suggestions/source | Suggest a data source. Suggest a primary data source to the editors: name, link, license, what it holds and why. Needs a personal key. Goes to the editors' queue; new sources are loaded only after the editors decide. Записи: не больше 60 в минуту с одного адреса, у аккаунта первых суток лимиты ниже; ключ заблокированного редакцией профиля — ошибка 403 blocked. / Writes: at most 60 a minute from one address, lower limits for an account in its first day; a key of a profile the editors blocked is a 403 blocked. |
submit_collection_draft | /api/v1/suggestions/collection | Submit a draft collection. A draft collection for the editors: a question, a kind (chain or build), 3 to 7 feed card ids (from get_popular_findings or /data/feed/ids.json; unknown ids are a 400), notes and a conclusion. Needs a personal key. Goes to the editors' queue; the conclusion must not claim causes the data do not show. Once the editors accept it, it becomes the author's own collection with status approved: a page under their handle (list_user_collections) and a cover in the general feed. Записи: не больше 60 в минуту с одного адреса, у аккаунта первых суток лимиты ниже; ключ заблокированного редакцией профиля — ошибка 403 blocked. / Writes: at most 60 a minute from one address, lower limits for an account in its first day; a key of a profile the editors blocked is a 403 blocked. |
my_suggestions | /api/v1/suggestions | My suggestions. The key owner's suggestions (by key, MCP and the site's profile) with their status (new, accepted, rejected) and the editors' reply. Needs a personal key. |
mark_important | /api/v1/important | Mark as important. Mark a card or collection as important on behalf of the key's owner, with a note (up to 280 characters; calling again changes the note). The mark is public: on the person's page, in get_user_profile and in their followers' feed; it is apart from the «interesting» votes. Ids come from get_popular_findings, list_collections, list_user_collections or /data/feed/ids.json; unknown ids are a 400. Needs a personal key. Записи: не больше 60 в минуту с одного адреса, у аккаунта первых суток лимиты ниже; ключ заблокированного редакцией профиля — ошибка 403 blocked. / Writes: at most 60 a minute from one address, lower limits for an account in its first day; a key of a profile the editors blocked is a 403 blocked. |
unmark_important | /api/v1/important/remove | Remove an important mark. Remove the key owner's important mark from a card or collection. Needs a personal key. Записи: не больше 60 в минуту с одного адреса, у аккаунта первых суток лимиты ниже; ключ заблокированного редакцией профиля — ошибка 403 blocked. / Writes: at most 60 a minute from one address, lower limits for an account in its first day; a key of a profile the editors blocked is a 403 blocked. |
follow | /api/v1/follows | Follow a person. Make the key's owner follow a person by handle: their important marks, new collections and suggestions the editors accepted come into the «Following» feed, and what they mark comes a little more often in the general feed. Needs a personal key. Записи: не больше 60 в минуту с одного адреса, у аккаунта первых суток лимиты ниже; ключ заблокированного редакцией профиля — ошибка 403 blocked. / Writes: at most 60 a minute from one address, lower limits for an account in its first day; a key of a profile the editors blocked is a 403 blocked. |
unfollow | /api/v1/follows/remove | Unfollow. Make the key's owner stop following a person. Needs a personal key. Записи: не больше 60 в минуту с одного адреса, у аккаунта первых суток лимиты ниже; ключ заблокированного редакцией профиля — ошибка 403 blocked. / Writes: at most 60 a minute from one address, lower limits for an account in its first day; a key of a profile the editors blocked is a 403 blocked. |
get_location | /api/v1/locations/{location} | Location profile. Key facts with sources, UN values 1950–2100, national statistics and the year from which they continue the UN series (national.un_join; national.published_decimals: decimals the source prints when fewer than two, e.g. DANE and SRS fertility «1.0»), UN-2024 check and related forecast cases. |
list_indicators | /api/v1/indicators | Indicators and units. All country and world indicators with definitions, units, sources, time basis and coverage: demography and forecasts, migration, markets and valuations, bond yields, economy, consumption and poverty, food, health, time use, culture, religion and beliefs, digital, communication restrictions and internet freedom, energy, industry and waste, land, climate, science, space and technology (R&D, patents, space budgets, electric cars), education and skills (comparable tests PISA, TIMSS, PIRLS, PIAAC; scales of different studies are not mixed), education and work (unemployment, employment and earnings by attainment: NY Fed, BLS, Eurostat, OECD, ILO; attainment levels differ by source), security. Observation kinds distinguish published values, surveys and model estimates. For internet_* indicators, STOP case counts differ from Freedom House expert scores (higher = freer); assessment years denote report editions. Other entity types use list_datasets. |
compare_indicators | /api/v1/compare | Compare two indicators across countries. Any two indicators for one year across all or chosen countries: X/Y points, Pearson and Spearman correlation, observations, years with data, a link to the all-countries view. |
get_forecast_checks | /api/v1/forecast-checks | Past UN, IMF and Eurostat forecasts vs actual. Past UN WPP revisions (population, births, deaths, fertility, infant mortality, net migration, life expectancy, mothers' age; source=components: why the population projection missed — revised start, births, deaths, migration) and IMF WEO forecasts (growth, inflation, debt, budget balance, current account, unemployment, GDP per capita, population), and for European countries Eurostat EUROPOP projections (fertility, population, migration, life expectancy), checked against actual data; without location, a summary across countries. |
get_series | /api/v1/series | Time series. Annual country and world series from list_indicators: demography and forecasts, economy, food, health, time use, culture, land, climate and technology. Published observations, surveys and model estimates retain their kind and time basis; gaps are not filled. Up to 10 locations and 6 indicators, with units and primary sources. Monthly snapshots on the annual axis use time_basis=last_published_month_in_year, with observation_periods and observation_qualities by year; the current year is not a full-year mean. Other entity types use get_dataset. |
rank_countries | /api/v1/countries | Rank countries. Country table with sorting and filters. |
list_forecast_cases | /api/v1/forecasts | Forecast-vs-actual cases. In-depth cases of archived official projections checked against actual data: demography (including national projections of Australia, New Zealand, Brazil, Chile, Colombia, Argentina, Peru and others), migration, US energy (EIA), forecasts of the Federal Reserve, the ECB and other central banks, the US Survey of Professional Forecasters, UK Treasury/OBR and European Commission growth forecasts (Greece, Italy), the US budget (CBO), world solar power (EIA), oil and gas prices (US EIA short-term outlooks), the US President’s budget assumptions, the Japanese government’s outlook, Russia’s budget assumptions (dollar rate, Urals oil, GDP growth, inflation); each has a section. |
get_forecast_case | /api/v1/forecasts/{case_id} | One forecast case. Actual series, archived projections and a check of each. |
get_un2024_vs_actual | /api/v1/un2024-vs-actual | UN 2024 vs actual births. UN medium variant vs national births for the countries whose national series matched the UN estimates in the years both exist. |
get_war_births | /api/v1/wars | Wars and births. Do births rise after a war, and where did wars make forecasts miss: every war on a country's territory since 1955 against its pre-war trend and 10 peace-time countries with the same fertility; big wars before 1946 against countries not at war; medians over all wars with a sign test; the world wars; monthly births after a war began; regions of Colombia, Mexico and Ukraine; UN projection errors in countries at war. With location: the country's war years and episodes. |
get_key_findings | /api/v1/findings | Key findings. Key findings computed from the data. |
get_claims | /api/v1/claims | Said and done: claims against facts. Public promises, targets and predictions with a number and a deadline (heads of government, ministers, parties, laws and strategies, central banks, scientists, company heads with kind executive) beside the outcome: the verbatim quote with translation, date and primary-source link, the promised value and deadline, the official fact at the deadline (and the Macroscope series when it exists), and the outcome either way; for an event promised by a date (promise.kind event: a landing, a first flight, the start of sales) fact.happened is its date or null, with fact.delay_years. Themes: migration, demography, waste, social, economy, energy, technology (electric cars, self-driving, company products, broadband, AI), climate, science (R&D, patents, supercomputers, fusion), space. The outcome compares numbers; it does not judge the person. |
get_sources | /api/v1/sources | Sources. Primary sources: UN WPP, national offices, forecast archives and unified-base providers, including everyday life, culture, platforms, land and science. Country filter applies to national publications; get_series/get_dataset specify exact coverage and inputs. |