{"name":"Macroscope API","description":{"ru":"Открытые данные Макроскопа: показатели 237 стран и мира на одной шкале времени — демография (ООН WPP 2024, национальная статистика 64 стран), интернет и связь (Всемирный банк, МСЭ), ВВП на душу, урбанизация, образование женщин, экономика МВФ — и официальные прогнозы ООН и МВФ, сверенные с фактом по каждой стране. get_insights отдаёт готовые наблюдения, те же, что под главным графиком сайта. Без ключа и регистрации.","en":"Open Macroscope data: indicators of 237 countries and the world on one time axis — demography (UN WPP 2024, national statistics of 64 countries), internet and telecoms (World Bank, ITU), GDP per capita, urbanisation, women's education, IMF economics — and official UN and IMF forecasts checked against actual data for every country. get_insights returns ready observations, the same as under the main chart of the site. No key or sign-up."},"data_date":"2026-10-05","start_here":["https://macroscope.is/api/v1/locations?query=корея — код страны / country code","https://macroscope.is/api/v1/insights?location=KOR&indicator=tfr,internet_users,urban_population — что видно в данных / what the data shows","https://macroscope.is/api/v1/series?location=KOR,JPN&indicator=tfr&from_year=2000 — ряды / series","https://macroscope.is/api/v1/forecast-checks?location=KOR&indicator=tfr — прошлые прогнозы против факта / past forecasts vs actual","https://macroscope.is/api/v1/compare?x=gdp_per_capita_ppp&y=tfr — все страны за год / all countries for one year","https://macroscope.is/api/v1/datasets — типизированные наборы повседневной жизни, компаний и игр / typed everyday-life, company and game datasets"],"endpoints":[{"name":"get_market_latest","method":"GET","path":"/api/v1/markets/latest","title":"Свежие месячные данные рынков / Latest monthly market observations","description":"Последние опубликованные месяцы: индексы акций и долгосрочные ставки ОЭСР, ставки США ФРС, CAPE, цены, прибыль и дивиденды Шиллера. У каждого показателя дата, источник и качество, сопоставление с тем же месяцем прошлого года и декабрём 2022; пропуски не заполнены; сравнения не пересекают разрыв методики B. Не котировки в реальном времени. / 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.","parameters":{"location":{"type":"string","description":"Страна ISO3 / country ISO3","required":true},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/markets/latest?location=USA"},{"name":"get_market_cycles","method":"GET","path":"/api/v1/markets/cycles","title":"Падения рынков и восстановление / Market drawdowns and recoveries","description":"Падения от наблюдаемого пика не менее 20%: акции по месячным индексам ОЭСР (при отсутствии — архив WDI), жильё по квартальным реальным ценам BIS. Пик, дно, глубина, восстановление и незавершённые эпизоды; вычислены при сборке. Годовая частота скрывает падения внутри года. Отсутствие данных не равно восстановлению. Это ценовые эпизоды, не каталог банковских кризисов и не диагноз пузыря. / 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.","parameters":{"location":{"type":"string","description":"Страна, ISO3 / country ISO3, e.g. USA or JPN","required":true},"asset":{"type":"string","enum":["equity","equity_wdi","housing"],"default":"equity"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/markets/cycles?location=JPN&asset=housing"},{"name":"list_datasets","method":"GET","path":"/api/v1/datasets","title":"Наборы данных: рынки, общество, интернет и криптоактивы / Market, society, internet and cryptoasset datasets","description":"Публичные наборы со своей структурой: рынки (капитализация и торги WDI, месячные доходности ФРС H.15, квартальные цены жилья BIS, месячные индексы ОЭСР и CAPE Шиллера, 164 банковских эпизода из МВФ 2026; ставки не равны доходности портфеля), ограничения интернета и связи (случаи Access Now STOP, территории, отчётные годы и неизвестные признаки), экспертные баллы Freedom House; криптоактивы (цены, капитализация, предложение, спотовые обороты, адреса и транзакции Coin Metrics; владение/использование по ФРС, ЕЦБ, FCA; собственные показатели сетей growthepie, выбранные пулы Curve и Uniswap из первичных API/блокчейна), религиозный состав и общины, вера и практика, смена принадлежности, религия мигрантов, ограничения религии; WVS/EVS с разными знаменателями, исторические конфессии и течения ислама; цифровое потребление (поисковые и ИИ-переходы Statcounter, обследования Eurostat/CNNIC/Pew/NTIA/Cetic/Ofcom, навыки и ИИ по группам, подростки и родители, новости и медиаграмотность, аудитории TikTok/Snapchat DSA, аккаунты WeChat/QQ), библиотеки, время людей, амиши, питомцы, COVID, GitHub, модели ИИ, отзывы научных статей, питание, земля, климат, Amazon/Ozon/RWB и Steam; сравнимые тесты образования (PISA, TIMSS, PIRLS, PIAAC со стандартными ошибками и флагами сопоставимости); диплом и работа (безработица, работа не по диплому и зарплаты выпускников США — ФРБ Нью-Йорка, месячная безработица 25+ по образованию BLS, безработица и занятость по возрасту и ISCED Евростата, ОЭСР «Образование в цифрах» со стандартными ошибками и относительными заработками, национальные обследования МОТ по всем странам — не модельные оценки). Показывает сущности, меры, периоды, лицензию и первоисточник. Доли людей, переходы, аккаунты и часы имеют разные определения; месяцы и годовые агрегаты не складываются. Адреса не люди, оборот не приток капитала; CC BY-NC 4.0 у Coin Metrics. count/observations относятся к найденным наборам до limit; catalog_datasets/catalog_observations — ко всей базе. / 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.","parameters":{"query":{"type":"string","description":"Поиск по названию, id или мере; internet — ограничения связи, markets — рынки, digital — цифровое потребление, crypto — криптоактивы / search title, id or measure; internet, markets, digital or crypto"},"entity_type":{"type":"string","description":"Например cryptoasset, blockchain, defi_pool, company, platform, game, country, world, region, library_system / entity type"},"limit":{"type":"integer","minimum":0,"maximum":100,"default":100},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/datasets?entity_type=company"},{"name":"get_dataset","method":"GET","path":"/api/v1/datasets/{dataset}","title":"Набор данных: наблюдения и происхождение / Dataset observations and provenance","description":"Одна небольшая страница наблюдений (до 100 строк), исходные единицы, тип и id сущности, начало/конец периода, временная база, JSON dimensions, флаги качества, ссылка на источник и SHA256 исходного файла. В ответе есть следующая страница и ссылки на полные CSV. Неравенства в dimensions.operator остаются границами, а не точными значениями. Для криптоактивов: month_end — значение на конец месяца, calendar_month — сумма или среднее согласно dimensions.aggregation, last_complete_day — собственная дата последнего наблюдения метрики. dated_snapshot — снимок резервов Curve с исходной временной меткой и блоком в dimensions. Собственные данные growthepie — CC BY 4.0; выбранные пулы не итог DeFi, а USDC/WETH не USD. Пропуски не заполняются, выборка токенов не весь рынок. Для религии: принадлежность, вера и практика различаются; вложенные переписные группы нельзя складывать, периоды и знаменатели сохранены. / 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.","parameters":{"dataset":{"type":"string","description":"Id из list_datasets / id from list_datasets","required":true},"page":{"type":"integer","minimum":0,"default":0,"description":"Страница с нуля / zero-based page"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/datasets/ozon_disclosed_metrics"},{"name":"search_locations","method":"GET","path":"/api/v1/locations","title":"Найти страну или регион / Find a country or region","description":"Ищет страны и регионы (237 стран, мир, регионы ООН, группы по доходу, ЕС) по названию на русском или английском или по коду и возвращает коды для других запросов. / Finds countries and regions by name or code and returns the codes used by other calls.","parameters":{"query":{"type":"string","description":"Часть названия или код; пусто — все / part of a name or a code; empty = all"},"type":{"type":"string","enum":["country","world","region","subregion","sdg","income","dev","union"],"description":"Тип / type"},"limit":{"type":"integer","minimum":1,"maximum":300,"default":50},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/locations?query=корея"},{"name":"get_insights","method":"GET","path":"/api/v1/insights","title":"Что видно в данных / What the data shows","description":"Главный инструмент для вопросов «почему», «что с чем связано», «насколько ошибались прогнозы», «куда идёт». Готовые наблюдения с числами по одной или нескольким странам (до 6) и показателям (до 6) — те же, что под главным графиком сайта: как менялся каждый показатель (пик, пороги вроде СКР 2,1, переломы тренда), что происходило с остальными показателями в годы самого резкого изменения главного, связь главного показателя с каждым другим по уровням и по изменениям год к году (с поправкой на автокорреляцию и проверкой сдвигов во времени), где страна стоит среди стран с тем же доходом (рождаемость, продолжительность жизни, интернет) и что обычно идёт первым по всем странам (горожан больше половины, жизнь дольше 60 лет, женщины в вузах, интернет — и падение рождаемости ниже 3 и 2,1), сколько прошлых выпусков ООН и МВФ ошиблись и в какую сторону (население, рождения, рождаемость, миграция, продолжительность жизни, рост, инфляция, бюджет), когда прогноз ждал сегодняшнего уровня, где МВФ и ООН расходятся в численности населения, и куда ведёт текущий прогноз. Показатели — от демографии и миграции до беженцев, электричества, цен на жильё и конфликтов. Для нескольких стран — сравнение. Ответ содержит view_url — тот же вид на сайте для человека. / 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.","parameters":{"location":{"type":"string","description":"Страна, несколько через запятую (до 6) или мир un-900: KOR, KOR,JPN / one or more countries","required":true},"indicator":{"type":"string","description":"До 6 id через запятую (см. list_indicators); первый — главный, с ним сравниваются остальные. По умолчанию tfr,births,internet_users,urban_population,gdp_per_capita_ppp / up to 6 ids; the first is the focus"},"from_year":{"type":"integer","minimum":1750,"maximum":2100,"default":1950},"to_year":{"type":"integer","minimum":1750,"maximum":2100,"default":2100},"forecasts":{"type":"boolean","default":true,"description":"Сверки прошлых прогнозов и текущий прогноз / past forecast checks and the current outlook"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/insights?location=KOR&indicator=tfr,internet_users,urban_population"},{"name":"get_popular_findings","method":"GET","path":"/api/v1/findings/popular","title":"Что людям интересно / What people find interesting","description":"Находки из ленты Макроскопа (карточки: два числа на одной шкале и год обгона — смертей больше, чем рождений, пожилых больше, чем детей, интернет против безопасной санитарии, страна против известной страны; ошибки прогнозов ООН и МВФ, в том числе по миграции и продолжительности жизни, расхождения МВФ и ООН, ВВП против электричества, что обычно идёт первым, страны с одинаковым стартом и разными путями, рекорды по мигрантам, беженцам, энергии и конфликтам) с анонимными счётчиками отметок посетителей «интересно / неинтересно». 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.","parameters":{"sort":{"type":"string","enum":["interesting","divisive","unrated"],"default":"interesting"},"location":{"type":"string","description":"Необязательно: страна / optional country"},"topic":{"type":"string","description":"Необязательно: forecasts, population, fertility, health, digital, economy, markets, migration, energy, security, causes, paths, records"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/findings/popular?sort=interesting"},{"name":"list_collections","method":"GET","path":"/api/v1/collections","title":"Коллекции карточек / Collections of cards","description":"Коллекции ленты Макроскопа: вопрос и карточки, которые на него отвечают, по порядку, и вывод с ключевыми числами и источниками. kind=chain — цепочка (каждая карточка отвечает на вопрос предыдущей), build — сборка (факты из разных областей сходятся к выводу); author=editorial — редакция. У каждой — страница (url: /s/<slug>/, это лента, открытая на коллекции) и короткая ссылка (short_url: /<код>). Целиком — get_collection. / 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.","parameters":{"kind":{"type":"string","enum":["chain","build"],"description":"Необязательно: chain или build / optional"},"topic":{"type":"string","description":"Необязательно: тема, как у карточек (population, economy, energy…) / optional topic"},"author":{"type":"string","description":"Необязательно: editorial / optional author"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/collections"},{"name":"get_collection","method":"GET","path":"/api/v1/collections/{collection}","title":"Коллекция карточек целиком / One collection of cards","description":"Одна коллекция по id (col:…), slug страницы на любом языке или короткому коду: вопрос, вступление, шаги — карточки по порядку (заголовок, текст, источник, ссылки на страницу карточки, короткую ссылку и график) со связками между ними — и вывод: заголовок, текст, ключевые числа (у каждого — карточка, откуда оно) и первоисточники. / 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.","parameters":{"collection":{"type":"string","description":"id (col:…), slug или короткий код (см. list_collections) / id, slug or short code","required":true},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/collections/col:fewer-babies-than-expected"},{"name":"get_user_profile","method":"GET","path":"/api/v1/users/{handle}","title":"Профиль человека / A person's profile","description":"Открытая часть профиля человека на Макроскопе по нику: имя, ник, инициалы, несколько слов о себе, месяц, с которого он здесь, ссылка на его страницу (/ru/u/<ник>/), сколько у него подписчиков и подписок, его открытые коллекции (до 20, не черновики, со статусом) и что он отметил важным (до 50, новые первыми, с его словами и ссылкой на карточку). Почта, отметки «интересно» и что человек читал не раскрываются. Без ключа. / 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.","parameters":{"handle":{"type":"string","description":"Ник, с @ или без / handle, with or without @","required":true},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/users/example"},{"name":"list_user_collections","method":"GET","path":"/api/v1/users/{handle}/collections","title":"Коллекции человека / A person's collections","description":"Открытые коллекции карточек, которые собрал человек с этим ником, новые первыми: вопрос, вид, карточки по порядку с его пояснениями, вывод автора, ссылка на страницу коллекции (/ru/u/<ник>/s/<id>/) и статус — published (открыта по ссылке и подписчикам), review (у редакции), approved (редакция приняла: только такие попадают в общую ленту), rejected (редакция не взяла, коллекция открыта по ссылке). Черновики не показываются. Коллекции редакции — list_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.","parameters":{"handle":{"type":"string","description":"Ник, с @ или без / handle, with or without @","required":true},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/users/example/collections"},{"name":"suggest_research","method":"POST","path":"/api/v1/suggestions/research","title":"Предложить исследование / Suggest a research question","description":"Предложить редакции вопрос или направление исследования: что стоит проверить на данных и почему, со ссылками. Нужен личный ключ (Authorization: Bearer mk_…; выдаётся в карточке «Профиль» ленты аккаунту с ником, раздел «Ключи для агентов»). Предложение уходит в очередь редакции и на сайт само не попадает; ответ — id и статус new, решение и ответ редакции — my_suggestions. / 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.","auth":"Authorization: Bearer mk_…","parameters":{"question":{"type":"string","description":"Вопрос, до 500 знаков (нужен question или direction) / the question, up to 500 characters (question or direction)"},"direction":{"type":"string","description":"Направление поиска, до 500 знаков / a direction, up to 500"},"why":{"type":"string","description":"Почему это интересно, до 2000 / why it matters, up to 2000"},"links":{"type":"array","items":{"type":"string"},"description":"До 10 ссылок http(s) / up to 10 http(s) links"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/suggestions/research","example_body":{"question":"Почему в Южной Корее рождаемость упала ниже, чем в Японии?","why":"Две соседние страны с похожей экономикой разошлись на 0,5 ребёнка","links":["https://kosis.kr/"],"lang":"ru"}},{"name":"suggest_source","method":"POST","path":"/api/v1/suggestions/source","title":"Предложить источник данных / Suggest a data source","description":"Предложить редакции первоисточник данных: название, ссылка, лицензия, что в нём есть и зачем он Макроскопу. Нужен личный ключ (Authorization: Bearer mk_…). Уходит в очередь редакции; загрузка новых источников — только после решения редакции. / 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.","auth":"Authorization: Bearer mk_…","parameters":{"name":{"type":"string","description":"Название, до 200 / name, up to 200","required":true},"url":{"type":"string","description":"Ссылка http(s) на первоисточник / http(s) link to the primary source","required":true},"license":{"type":"string","description":"Лицензия, до 200 / license, up to 200"},"what":{"type":"string","description":"Что в нём: показатели, страны, годы; до 2000 / what it holds: indicators, countries, years; up to 2000","required":true},"why":{"type":"string","description":"Зачем он сайту, до 2000 / why the site needs it, up to 2000"}},"formats":["json"],"example":"https://macroscope.is/api/v1/suggestions/source","example_body":{"name":"KOSIS","url":"https://kosis.kr/eng/","license":"KOGL Type 1","what":"Рождения и коэффициент рождаемости Кореи по месяцам с 1970 года"}},{"name":"submit_collection_draft","method":"POST","path":"/api/v1/suggestions/collection","title":"Предложить коллекцию карточек / Submit a draft collection","description":"Черновик коллекции для редакции: вопрос, вид (chain — каждая карточка отвечает на вопрос предыдущей, build — факты из разных областей сходятся к выводу), 3–7 карточек ленты по id (из get_popular_findings или /data/feed/ids.json; неизвестные id — ошибка 400), заметки к шагам и вывод. Нужен личный ключ (Authorization: Bearer mk_…). Уходит в очередь редакции; вывод не должен утверждать причин, которых данные не показывают. Принятый редакцией черновик становится коллекцией автора со статусом approved: страница под его ником (list_user_collections) и обложка в общей ленте. / 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.","auth":"Authorization: Bearer mk_…","parameters":{"question":{"type":"string","description":"Вопрос коллекции, до 300 / the question, up to 300","required":true},"kind":{"type":"string","enum":["chain","build"],"required":true},"cards":{"type":"array","items":{"type":"string"},"minItems":3,"maxItems":7,"description":"3–7 id карточек ленты по порядку / 3 to 7 feed card ids in order","required":true},"notes":{"type":"string","description":"Связки между карточками, до 2000 / notes between cards, up to 2000"},"conclusion":{"type":"string","description":"Вывод, до 2000 / conclusion, up to 2000"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/suggestions/collection","example_body":{"question":"Почему детей рождается меньше, чем ждали?","kind":"chain","cards":["race_tfr:CHN:JPN","race_age:CHN:USA","imf_blind:WLD"],"lang":"ru"}},{"name":"my_suggestions","method":"GET","path":"/api/v1/suggestions","title":"Мои предложения / My suggestions","description":"Предложения владельца ключа (по ключу, через MCP и из профиля на сайте) со статусом — new (ждёт редакции), accepted, rejected — и ответом редакции. Нужен личный ключ (Authorization: Bearer mk_…). / 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.","auth":"Authorization: Bearer mk_…","parameters":{"status":{"type":"string","enum":["new","accepted","rejected"],"description":"Необязательно / optional"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/suggestions"},{"name":"mark_important","method":"POST","path":"/api/v1/important","title":"Отметить важным / Mark as important","description":"Отметить карточку или коллекцию «Важное» от имени владельца ключа, с его словами (до 280 знаков; повторный вызов меняет слова). Отметка открытая: видна на странице человека, в get_user_profile и в ленте его подписчиков («<имя> отметил(а) важным»); с отметками «интересно» не связана. id — из get_popular_findings, list_collections, list_user_collections или /data/feed/ids.json; неизвестный id — ошибка 400. Нужен личный ключ (Authorization: Bearer mk_…). / 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.","auth":"Authorization: Bearer mk_…","parameters":{"item":{"type":"string","description":"id карточки или коллекции (col:…) / card or collection id","required":true},"note":{"type":"string","description":"Почему это важно, до 280 знаков / why it matters, up to 280"}},"formats":["json"],"example":"https://macroscope.is/api/v1/important","example_body":{"item":"imf_blind:WLD","note":"Прогнозы МВФ на год вперёд — с какой ошибкой"}},{"name":"unmark_important","method":"POST","path":"/api/v1/important/remove","title":"Снять отметку «Важное» / Remove an important mark","description":"Снять отметку «Важное» владельца ключа с карточки или коллекции. Нужен личный ключ (Authorization: Bearer mk_…). / 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.","auth":"Authorization: Bearer mk_…","parameters":{"item":{"type":"string","description":"id карточки или коллекции / card or collection id","required":true}},"formats":["json"],"example":"https://macroscope.is/api/v1/important/remove","example_body":{"item":"imf_blind:WLD"}},{"name":"follow","method":"POST","path":"/api/v1/follows","title":"Подписаться на человека / Follow a person","description":"Подписать владельца ключа на человека по нику: его отметки «Важное», новые коллекции и принятые редакцией предложения появятся в ленте «Подписки», а отмеченное им чуть чаще попадает в общую ленту. Нужен личный ключ (Authorization: Bearer mk_…). / 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.","auth":"Authorization: Bearer mk_…","parameters":{"handle":{"type":"string","description":"Ник, с @ или без / handle, with or without @","required":true}},"formats":["json"],"example":"https://macroscope.is/api/v1/follows","example_body":{"handle":"example"}},{"name":"unfollow","method":"POST","path":"/api/v1/follows/remove","title":"Отписаться / Unfollow","description":"Отписать владельца ключа от человека по нику. Нужен личный ключ (Authorization: Bearer mk_…). / 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.","auth":"Authorization: Bearer mk_…","parameters":{"handle":{"type":"string","description":"Ник, с @ или без / handle, with or without @","required":true}},"formats":["json"],"example":"https://macroscope.is/api/v1/follows/remove","example_body":{"handle":"example"}},{"name":"get_location","method":"GET","path":"/api/v1/locations/{location}","title":"Профиль страны или региона / Location profile","description":"Главное о стране или регионе: последняя рождаемость и рождения с источником, пик рождений, ключевые значения ООН (1950–2100), национальная статистика с примечаниями и с какого года она продолжает ряд ООН (national.un_join: join_year, расхождение с оценками ООН по годам; national.published_decimals — сколько знаков после запятой даёт источник, если меньше двух: рождаемость DANE и SRS «1,0»), сверка с прогнозом ООН-2024, связанные случаи «прогноз против факта». / 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.","parameters":{"location":{"type":"string","description":"Страна или регион: название по-русски или по-английски, ISO3 (KOR), код региона (un-900 — мир) / country or region: name, ISO3 or region code","required":true},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/locations/KOR"},{"name":"list_indicators","method":"GET","path":"/api/v1/indicators","title":"Показатели и единицы / Indicators and units","description":"Все показатели стран и мира с определениями, единицами, источниками, временной базой и охватом: демография и прогнозы, миграция, рынки и оценки, облигации и ставки, экономика, потребление и бедность, питание, здоровье, время людей, культура, религия и убеждения, цифровизация, ограничения связи и свобода интернета, энергия, промышленность и отходы, земля, климат, наука, космос и технологии (исследования, патенты, космические бюджеты, электромобили), образование и навыки (сравнимые тесты PISA, TIMSS, PIRLS, PIAAC; шкалы разных исследований не смешиваются), диплом и работа (безработица, занятость и заработки по уровню образования: ФРБ Нью-Йорка, BLS, Евростат, ОЭСР, МОТ; уровни образования у источников разные), безопасность. Тип наблюдения отличает опубликованные значения от обследований и модельных оценок. Для показателей internet_* случаи STOP отличаются от экспертных баллов Freedom House (больше — свободнее); год оценки обозначает выпуск. Наборы других сущностей доступны через list_datasets. / 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.","parameters":{"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/indicators"},{"name":"compare_indicators","method":"GET","path":"/api/v1/compare","title":"Сравнить два показателя по странам / Compare two indicators across countries","description":"Любые два показателя базы (демография, миграция и беженцы, интернет и связь, ВВП, урбанизация, образование, экономика МВФ, цены на жильё, электричество, конфликты) за один год по всем странам или выбранным: точки X и Y, корреляции Пирсона и Спирмена, наблюдения (медианы для трети стран с наименьшим и наибольшим X), годы с данными, ссылка на вид «Все страны» на сайте. / 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.","parameters":{"x":{"type":"string","description":"Показатель X, например gdp_per_capita_ppp (см. list_indicators) / indicator id","required":true},"y":{"type":"string","description":"Показатель Y, например internet_users / indicator id","required":true},"year":{"type":"integer","minimum":1750,"maximum":2100,"description":"Год; по умолчанию последний с хорошим охватом / year; default: latest with good coverage"},"location":{"type":"string","description":"Необязательно: страны через запятую (до 60); по умолчанию все / optional comma-separated countries"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/compare?x=gdp_per_capita_ppp&y=internet_users"},{"name":"get_forecast_checks","method":"GET","path":"/api/v1/forecast-checks","title":"Прошлые прогнозы ООН, МВФ и Евростата против факта / Past UN, IMF and Eurostat forecasts vs actual","description":"Сверка прошлых выпусков прогноза ООН (WPP 1998–2022: население, рождения, смерти, рождаемость, младенческая смертность, чистая миграция, продолжительность жизни мужчин и женщин, возраст матери; source=components — почему ошибся прогноз населения: пересчёт старта, рождения, смерти, миграция) и прогнозов МВФ (WEO: рост ВВП, инфляция, долг, баланс бюджета, текущий счёт, безработица, ВВП на душу, население) с фактом по любой стране, а для стран Европы — прогнозов Евростата EUROPOP 2013–2025 (рождаемость, население, миграция, продолжительность жизни). Без location — сводка по всем странам: медианная ошибка и доли ошибок в каждую сторону. / 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.","parameters":{"location":{"type":"string","description":"Необязательно: страна или мир (un-900) / optional country or the world"},"indicator":{"type":"string","description":"Через запятую: population, births, deaths, tfr, infant_mortality, net_migration, net_migration_rate, life_expectancy_female, life_expectancy_male, mean_age_childbearing, gdp_growth, inflation, gov_debt, gov_balance, current_account, unemployment, gdp_per_capita_usd"},"source":{"type":"string","enum":["wpp","weo","europop","components"],"description":"wpp — ООН, weo — МВФ, europop — Евростат (Европа), components — разбор ошибки прогноза населения ООН по причинам; по умолчанию все"},"release":{"type":"string","description":"Выпуск: wpp2010, weo2019-10… / one release"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/forecast-checks?location=KOR&indicator=tfr"},{"name":"get_series","method":"GET","path":"/api/v1/series","title":"Временные ряды / Time series","description":"Годовые ряды любых показателей стран и мира из list_indicators: демография и прогнозы, экономика, питание, здоровье, время людей, культура, земля, климат и технологии. Опубликованные наблюдения, обследования и модельные оценки сохраняют kind и временную базу источника; пропуски не заполняются. До 10 стран и 6 показателей за запрос, с единицами и первоисточниками. Месячные снимки на годовой оси имеют time_basis=last_published_month_in_year, observation_periods и observation_qualities по годам; текущий год не является полным годовым средним. Компании, игры, общины и другие сущности — через get_dataset. / 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.","parameters":{"location":{"type":"string","description":"Одна или несколько через запятую: KOR,JPN / one or more, comma-separated","required":true},"indicator":{"type":"string","description":"Через запятую: births,tfr,internet_users,gdp_per_capita_ppp… (см. list_indicators) / comma-separated ids","required":true},"from_year":{"type":"integer","minimum":1750,"maximum":2100,"default":1750,"description":"Длинные ряды HMD (births_hist, birth_rate_hist) начинаются в XVIII веке / long HMD series start in the 1700s"},"to_year":{"type":"integer","minimum":1750,"maximum":2100,"default":2100},"kind":{"type":"string","description":"Через запятую: actual, estimate, projection_medium, projection_low, projection_lower95, projection_upper95, national или all; по умолчанию actual,estimate,projection_medium,national. / Comma-separated kinds; default: actual,estimate,projection_medium,national."},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/series?location=KOR&indicator=births,tfr&from_year=2000&to_year=2050"},{"name":"rank_countries","method":"GET","path":"/api/v1/countries","title":"Сравнить страны / Rank countries","description":"Таблица 237 стран: последняя рождаемость и рождения, падение от пика, население 2024, прогноз ООН на 2100 год, медианный возраст, нагрузка пожилыми; сортировка, фильтр по региону и размеру. / Country table with sorting and filters.","parameters":{"sort_by":{"type":"string","enum":["tfr_latest","births_latest_k","births_change_from_peak_pct","peak_births_k","population_2024_k","un_medium_population_2100_k","un_medium_change_2024_2100_pct","un_low_change_2024_2100_pct","median_age_2024","old_age_dependency_2025","old_age_dependency_2050","name"],"default":"tfr_latest"},"order":{"type":"string","enum":["asc","desc"],"default":"asc"},"limit":{"type":"integer","minimum":1,"maximum":237,"default":20},"region":{"type":"string","description":"Регион: un-908 Европа, un-935 Азия, un-903 Африка… / region code or name"},"group":{"type":"string","enum":["hardest_cases","largest"],"description":"hardest_cases — очень низкая рождаемость; largest — 30 крупнейших"},"min_population_k":{"type":"number","minimum":0,"description":"Население 2024 не меньше, тыс. / minimum population 2024, thousands"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/countries?sort_by=tfr_latest&order=asc&limit=10&min_population_k=1000"},{"name":"list_forecast_cases","method":"GET","path":"/api/v1/forecasts","title":"Случаи «прогноз против факта» / Forecast-vs-actual cases","description":"Подробные случаи, где архивы официальных прогнозов сверены с фактом: демография (IPSS, статистика Кореи и Тайваня, ООН, SSA, ONS, Евростат, Destatis, ISTAT, Росстат, а также национальные прогнозы Австралии, Новой Зеландии, Бразилии, Чили, Колумбии, Аргентины, Перу и других), миграция, энергетика США (EIA: газ, нефть, уголь, CO₂, ветер, солнце, цена нефти), прогнозы ФРС, ЕЦБ и других центробанков, опрос профессиональных прогнозистов США (ФРБ Филадельфии), прогнозы роста Минфина и Управления бюджетной ответственности Великобритании и Еврокомиссии (Греция, Италия), бюджет США (CBO), мировая солнечная энергетика (EIA), цены нефти и газа (краткосрочные прогнозы Минэнерго США), допущения бюджетов президента США, прогнозы правительства Японии, допущения бюджета России (курс доллара, нефть Urals, рост ВВП, инфляция). У каждого — раздел (section). / 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.","parameters":{"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/forecasts"},{"name":"get_forecast_case","method":"GET","path":"/api/v1/forecasts/{case_id}","title":"Прогнозы и факт по случаю / One forecast case","description":"Фактический ряд, все архивные прогнозы и разбор каждого: что ждали на последний год с фактом, расхождение, в каком году прогноз ждал сегодняшнего уровня. / Actual series, archived projections and a check of each.","parameters":{"case_id":{"type":"string","description":"Например jpn_births, kor_tfr, chn_un (см. list_forecast_cases)","required":true},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/forecasts/jpn_births"},{"name":"get_un2024_vs_actual","method":"GET","path":"/api/v1/un2024-vs-actual","title":"Прогноз ООН-2024 против фактических рождений / UN 2024 vs actual births","description":"По странам с данными за 2024–2025 годы, где национальный ряд рождений совпадал с оценками ООН в общие годы: рождения по среднему варианту ООН (июль 2024) против национальной статистики, расхождение и выход за 95%-интервал. / UN medium variant vs national births for the countries whose national series matched the UN estimates in the years both exist.","parameters":{"location":{"type":"string","description":"Необязательно: одна страна / optional single country"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/un2024-vs-actual"},{"name":"get_war_births","method":"GET","path":"/api/v1/wars","title":"Войны и рождения / Wars and births","description":"Растёт ли рождаемость после войны и где из-за войн ошибались прогнозы. Каждая война на территории страны с 1955 года (UCDP/PRIO) против довоенного тренда и 10 мирных стран с той же рождаемостью: рождения, рождаемость и рождения на 1000 жителей во время войны, через 1–5 и 6–10 лет; большие войны до 1946 года (Первая и Вторая мировые и раньше) против стран, которые не воевали, по рождениям Human Mortality Database; медианы по всем войнам с тестом знаков; мировые войны (индекс рождений воевавших и нейтральных стран); рождения по месяцам после начала войны (Украина, Россия, Израиль, Армения, Азербайджан и другие, где есть месячные данные); регионы Колумбии, Мексики и Украины; ошибки прогнозов ООН в странах войны и их причины. С location — годы войн страны и её эпизоды. / 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.","parameters":{"location":{"type":"string","description":"Необязательно: страна / optional country"},"part":{"type":"string","enum":["all","summary","episodes","world_wars","monthly","regional","forecasts"],"default":"all","description":"Часть ответа / part of the answer"},"kind":{"type":"string","enum":["modern","historic"],"description":"Только войны с 1955 года (modern) или до 1950-го (historic) / only modern or historic wars"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/wars?location=BIH"},{"name":"get_key_findings","method":"GET","path":"/api/v1/findings","title":"Главные выводы / Key findings","description":"Главные выводы Макроскопа, посчитанные из данных (те же, что на сайте). / Key findings computed from the data.","parameters":{"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/findings"},{"name":"get_claims","method":"GET","path":"/api/v1/claims","title":"Сказано и сделано: заявления против фактов / Said and done: claims against facts","description":"Публичные обещания, цели и прогнозы с числом и сроком — главы правительств, министры, партии, законы и стратегии, центробанки, учёные, руководители компаний (kind executive) — рядом с тем, что вышло: дословная цитата на языке оригинала с переводом, дата и ссылка на первоисточник, обещанное значение и срок, факт к сроку из официальной статистики (и ряд базы Макроскопа, если он есть), исход в обе стороны: met, exceeded, near, late, missed, met_then_reversed; для события к дате (promise.kind event: посадка, первый полёт, начало продаж) — fact.happened, дата события или null, и fact.delay_years. Темы: migration, demography, waste, social, economy, energy, technology (электромобили, автономное вождение, продукты компаний, связь, ИИ), climate, science (ИиР, патенты, суперкомпьютеры, синтез), space. Исход — сравнение чисел, а не оценка человека. / 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.","parameters":{"theme":{"type":"string","enum":["migration","demography","waste","social","economy","energy","technology","climate","science","space"]},"country":{"type":"string","description":"ISO3, EU или название / ISO3, EU or name"},"outcome":{"type":"string","enum":["met","exceeded","near","late","missed","met_then_reversed"]},"topic":{"type":"string","description":"Например net_migration, fertility, recycling, poverty, growth / e.g. net_migration, fertility, recycling, poverty, growth"},"query":{"type":"string","description":"Поиск по имени, должности, партии, цитате / search name, role, party, quote"},"id":{"type":"string","description":"Одно заявление целиком: ряд факта, оговорки, как проверено / one claim in full"},"detail":{"type":"string","enum":["brief","full"],"default":"brief","description":"full — с рядом факта и оговорками / with fact series and caveats"},"limit":{"type":"integer","minimum":1,"maximum":300,"default":50},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"},"format":{"type":"string","enum":["json","csv"],"default":"json","description":"csv — таблица вместо JSON / csv for a table"}},"formats":["json","csv"],"example":"https://macroscope.is/api/v1/claims?theme=migration"},{"name":"get_sources","method":"GET","path":"/api/v1/sources","title":"Источники / Sources","description":"Первоисточники: ООН WPP 2024, национальные ведомства, архивы прогнозов и поставщики единой базы, включая повседневную жизнь, культуру, платформы, землю и науку; национальные публикации можно отфильтровать по стране. Точное покрытие и исходные файлы — в get_series/get_dataset. / 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.","parameters":{"location":{"type":"string","description":"Необязательно / optional"},"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.is/api/v1/sources?location=JPN"}],"mcp":{"url":"https://macroscope.is/mcp","transport":"streamable-http (POST JSON-RPC 2.0; чтение без авторизации, запись — с личным ключом в заголовке Authorization: Bearer mk_… / reading needs no auth, writing takes a personal key in the Authorization header)","tools":["get_market_latest","get_market_cycles","list_datasets","get_dataset","search_locations","get_insights","get_popular_findings","list_collections","get_collection","get_user_profile","list_user_collections","suggest_research","suggest_source","submit_collection_draft","my_suggestions","mark_important","unmark_important","follow","unfollow","get_location","list_indicators","compare_indicators","get_forecast_checks","get_series","rank_countries","list_forecast_cases","get_forecast_case","get_un2024_vs_actual","get_war_births","get_key_findings","get_claims","get_sources"],"note":"Те же операции как инструменты MCP: подключите адрес как коннектор в Claude, ChatGPT или другом клиенте MCP. / The same operations as MCP tools."},"writing":{"ru":"Запись — только предложения редакции: suggest_research (вопрос или направление исследования), suggest_source (источник данных), submit_collection_draft (черновик коллекции из 3–7 карточек ленты); my_suggestions — их статус и ответ редакции. Нужен личный ключ: аккаунт с ником, карточка «Профиль» в ленте → «Ключи для агентов» (до 5 ключей, ключ показывается один раз, отозвать можно там же). Ключ — в заголовке Authorization: Bearer mk_… и для REST (POST JSON), и для MCP (заголовок HTTP-запроса к /mcp). Всё уходит в очередь, редакция принимает или отклоняет и отвечает; на сайт само ничего не попадает. Лимиты: 20 предложений в час на ключ, 30 в час и 100 в сутки на профиль.","en":"Writing is suggestions to the editors only: suggest_research, suggest_source, submit_collection_draft (3 to 7 feed cards); my_suggestions gives their status and the editors' reply. It needs a personal key: an account with a handle, the feed's «Profile» card → «Keys for agents» (up to 5 keys, each shown once, revoked there). The key goes in Authorization: Bearer mk_… for REST (POST JSON) and for MCP (a header of the HTTP request to /mcp). Everything waits in a queue for the editors to accept or reject and reply; nothing reaches the site by itself. Limits: 20 suggestions an hour per key, 30 an hour and 100 a day per profile."},"openapi":"https://macroscope.is/api/v1/openapi.json","llms_txt":"https://macroscope.is/llms.txt","files":"https://macroscope.is/data/catalog.json","site":"https://macroscope.is/","conventions":{"language":"lang=ru (по умолчанию / default) или en","units":"население и рождения — тыс. (population and births in thousands); tfr — детей на женщину (children per woman); остальные — в /api/v1/indicators (others in /api/v1/indicators)","views":"ссылка на вид графика / chart view link: /ru/chart/?c=KOR,JPN&i=tfr,internet_users&from=1990&to=2050, по-английски /en/chart/?c=… (c — ISO3, WLD — мир; past=1 — прошлые прогнозы; view=xy&x=…&y=… — все страны)","pages":"адреса страниц / page addresses: /ru/… и /en/… (корень / — на язык посетителя / the root sends a visitor to their language); /ru/c/<slug>/ — карточка ленты (a card of the feed), /ru/chart/<slug>/ — готовый вопрос графика (a ready question of the chart), /ru/country/<slug>/ — страна (a country); все slug — https://macroscope.is/data/routes.json (every slug); короткая ссылка / short link: https://macroscope.is/<код> (3 знака / 3 signs, e.g. /k7f) — 301 на страницу карточки, страны или вопроса на языке читателя / a 301 to the page of the card, country or question in the reader's language; коды / codes: routes.json (code), /data/short.json","causality":"совпадение во времени не доказывает причину; ошибки прогнозов бывают в обе стороны / association is not cause; forecast errors go both ways","latest_values":"национальная статистика за 2023 год и позже, иначе оценка ООН за 2023 год / national statistics for 2023 or later, otherwise the UN estimate for 2023","missing":"null","errors":"{\"error\": {\"code\", \"message\", ...}} c HTTP 400/404; запись / writing: 401 без ключа или с отозванным / no key or a revoked one, 429 лимиты / limits"},"license":"Terms differ by source: UN WPP CC BY 3.0 IGO; World Bank CC BY 4.0 with exceptions; Eurostat attribution; GitHub and Wikimedia CC0; scientific and corporate numeric extracts have their own attribution/usage requirements. Read license and notes in dataset metadata.","cite":"Macroscope (https://macroscope.is) and the primary source named in the response"}