get_market_latest | /api/v1/markets/latest | Свежие месячные данные рынков. Последние опубликованные месяцы: индексы акций и долгосрочные ставки ОЭСР, ставки США ФРС, CAPE, цены, прибыль и дивиденды Шиллера. У каждого показателя дата, источник и качество, сопоставление с тем же месяцем прошлого года и декабрём 2022; пропуски не заполнены; сравнения не пересекают разрыв методики B. Не котировки в реальном времени. |
get_market_cycles | /api/v1/markets/cycles | Падения рынков и восстановление. Падения от наблюдаемого пика не менее 20%: акции по месячным индексам ОЭСР (при отсутствии — архив WDI), жильё по квартальным реальным ценам BIS. Пик, дно, глубина, восстановление и незавершённые эпизоды; вычислены при сборке. Годовая частота скрывает падения внутри года. Отсутствие данных не равно восстановлению. Это ценовые эпизоды, не каталог банковских кризисов и не диагноз пузыря. |
list_datasets | /api/v1/datasets | Наборы данных: рынки, общество, интернет и криптоактивы. Публичные наборы со своей структурой: рынки (капитализация и торги 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 — ко всей базе. |
get_dataset | /api/v1/datasets/{dataset} | Набор данных: наблюдения и происхождение. Одна небольшая страница наблюдений (до 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. Пропуски не заполняются, выборка токенов не весь рынок. Для религии: принадлежность, вера и практика различаются; вложенные переписные группы нельзя складывать, периоды и знаменатели сохранены. |
search_locations | /api/v1/locations | Найти страну или регион. Ищет страны и регионы (237 стран, мир, регионы ООН, группы по доходу, ЕС) по названию на русском или английском или по коду и возвращает коды для других запросов. |
get_insights | /api/v1/insights | Что видно в данных. Главный инструмент для вопросов «почему», «что с чем связано», «насколько ошибались прогнозы», «куда идёт». Готовые наблюдения с числами по одной или нескольким странам (до 6) и показателям (до 6) — те же, что под главным графиком сайта: как менялся каждый показатель (пик, пороги вроде СКР 2,1, переломы тренда), что происходило с остальными показателями в годы самого резкого изменения главного, связь главного показателя с каждым другим по уровням и по изменениям год к году (с поправкой на автокорреляцию и проверкой сдвигов во времени), где страна стоит среди стран с тем же доходом (рождаемость, продолжительность жизни, интернет) и что обычно идёт первым по всем странам (горожан больше половины, жизнь дольше 60 лет, женщины в вузах, интернет — и падение рождаемости ниже 3 и 2,1), сколько прошлых выпусков ООН и МВФ ошиблись и в какую сторону (население, рождения, рождаемость, миграция, продолжительность жизни, рост, инфляция, бюджет), когда прогноз ждал сегодняшнего уровня, где МВФ и ООН расходятся в численности населения, и куда ведёт текущий прогноз. Показатели — от демографии и миграции до беженцев, электричества, цен на жильё и конфликтов. Для нескольких стран — сравнение. Ответ содержит view_url — тот же вид на сайте для человека. |
get_popular_findings | /api/v1/findings/popular | Что людям интересно. Находки из ленты Макроскопа (карточки: два числа на одной шкале и год обгона — смертей больше, чем рождений, пожилых больше, чем детей, интернет против безопасной санитарии, страна против известной страны; ошибки прогнозов ООН и МВФ, в том числе по миграции и продолжительности жизни, расхождения МВФ и ООН, ВВП против электричества, что обычно идёт первым, страны с одинаковым стартом и разными путями, рекорды по мигрантам, беженцам, энергии и конфликтам) с анонимными счётчиками отметок посетителей «интересно |
list_collections | /api/v1/collections | Коллекции карточек. Коллекции ленты Макроскопа: вопрос и карточки, которые на него отвечают, по порядку, и вывод с ключевыми числами и источниками. kind=chain — цепочка (каждая карточка отвечает на вопрос предыдущей), build — сборка (факты из разных областей сходятся к выводу); author=editorial — редакция. У каждой — страница (url: /s/<slug>/, это лента, открытая на коллекции) и короткая ссылка (short_url: /<код>). Целиком — get_collection. |
get_collection | /api/v1/collections/{collection} | Коллекция карточек целиком. Одна коллекция по id (col:…), slug страницы на любом языке или короткому коду: вопрос, вступление, шаги — карточки по порядку (заголовок, текст, источник, ссылки на страницу карточки, короткую ссылку и график) со связками между ними — и вывод: заголовок, текст, ключевые числа (у каждого — карточка, откуда оно) и первоисточники. |
get_user_profile | /api/v1/users/{handle} | Профиль человека. Открытая часть профиля человека на Макроскопе по нику: имя, ник, инициалы, несколько слов о себе, месяц, с которого он здесь, ссылка на его страницу (/ru/u/<ник>/), сколько у него подписчиков и подписок, его открытые коллекции (до 20, не черновики, со статусом) и что он отметил важным (до 50, новые первыми, с его словами и ссылкой на карточку). Почта, отметки «интересно» и что человек читал не раскрываются. Без ключа. |
list_user_collections | /api/v1/users/{handle}/collections | Коллекции человека. Открытые коллекции карточек, которые собрал человек с этим ником, новые первыми: вопрос, вид, карточки по порядку с его пояснениями, вывод автора, ссылка на страницу коллекции (/ru/u/<ник>/s/<id>/) и статус — published (открыта по ссылке и подписчикам), review (у редакции), approved (редакция приняла: только такие попадают в общую ленту), rejected (редакция не взяла, коллекция открыта по ссылке). Черновики не показываются. Коллекции редакции — list_collections. Без ключа. |
suggest_research | /api/v1/suggestions/research | Предложить исследование. Предложить редакции вопрос или направление исследования: что стоит проверить на данных и почему, со ссылками. Нужен личный ключ (Authorization: Bearer mk_…; выдаётся в карточке «Профиль» ленты аккаунту с ником, раздел «Ключи для агентов»). Предложение уходит в очередь редакции и на сайт само не попадает; ответ — id и статус new, решение и ответ редакции — my_suggestions. |
suggest_source | /api/v1/suggestions/source | Предложить источник данных. Предложить редакции первоисточник данных: название, ссылка, лицензия, что в нём есть и зачем он Макроскопу. Нужен личный ключ (Authorization: Bearer mk_…). Уходит в очередь редакции; загрузка новых источников — только после решения редакции. |
submit_collection_draft | /api/v1/suggestions/collection | Предложить коллекцию карточек. Черновик коллекции для редакции: вопрос, вид (chain — каждая карточка отвечает на вопрос предыдущей, build — факты из разных областей сходятся к выводу), 3–7 карточек ленты по id (из get_popular_findings или /data/feed/ids.json; неизвестные id — ошибка 400), заметки к шагам и вывод. Нужен личный ключ (Authorization: Bearer mk_…). Уходит в очередь редакции; вывод не должен утверждать причин, которых данные не показывают. Принятый редакцией черновик становится коллекцией автора со статусом approved: страница под его ником (list_user_collections) и обложка в общей ленте. |
my_suggestions | /api/v1/suggestions | Мои предложения. Предложения владельца ключа (по ключу, через MCP и из профиля на сайте) со статусом — new (ждёт редакции), accepted, rejected — и ответом редакции. Нужен личный ключ (Authorization: Bearer mk_…). |
mark_important | /api/v1/important | Отметить важным. Отметить карточку или коллекцию «Важное» от имени владельца ключа, с его словами (до 280 знаков; повторный вызов меняет слова). Отметка открытая: видна на странице человека, в get_user_profile и в ленте его подписчиков («<имя> отметил(а) важным»); с отметками «интересно» не связана. id — из get_popular_findings, list_collections, list_user_collections или /data/feed/ids.json; неизвестный id — ошибка 400. Нужен личный ключ (Authorization: Bearer mk_…). |
unmark_important | /api/v1/important/remove | Снять отметку «Важное». Снять отметку «Важное» владельца ключа с карточки или коллекции. Нужен личный ключ (Authorization: Bearer mk_…). |
follow | /api/v1/follows | Подписаться на человека. Подписать владельца ключа на человека по нику: его отметки «Важное», новые коллекции и принятые редакцией предложения появятся в ленте «Подписки», а отмеченное им чуть чаще попадает в общую ленту. Нужен личный ключ (Authorization: Bearer mk_…). |
unfollow | /api/v1/follows/remove | Отписаться. Отписать владельца ключа от человека по нику. Нужен личный ключ (Authorization: Bearer mk_…). |
get_location | /api/v1/locations/{location} | Профиль страны или региона. Главное о стране или регионе: последняя рождаемость и рождения с источником, пик рождений, ключевые значения ООН (1950–2100), национальная статистика с примечаниями и с какого года она продолжает ряд ООН (national.un_join: join_year, расхождение с оценками ООН по годам; national.published_decimals — сколько знаков после запятой даёт источник, если меньше двух: рождаемость DANE и SRS «1,0»), сверка с прогнозом ООН-2024, связанные случаи «прогноз против факта». |
list_indicators | /api/v1/indicators | Показатели и единицы. Все показатели стран и мира с определениями, единицами, источниками, временной базой и охватом: демография и прогнозы, миграция, рынки и оценки, облигации и ставки, экономика, потребление и бедность, питание, здоровье, время людей, культура, религия и убеждения, цифровизация, ограничения связи и свобода интернета, энергия, промышленность и отходы, земля, климат, наука, космос и технологии (исследования, патенты, космические бюджеты, электромобили), образование и навыки (сравнимые тесты PISA, TIMSS, PIRLS, PIAAC; шкалы разных исследований не смешиваются), диплом и работа (безработица, занятость и заработки по уровню образования: ФРБ Нью-Йорка, BLS, Евростат, ОЭСР, МОТ; уровни образования у источников разные), безопасность. Тип наблюдения отличает опубликованные значения от обследований и модельных оценок. Для показателей internet_* случаи STOP отличаются от экспертных баллов Freedom House (больше — свободнее); год оценки обозначает выпуск. Наборы других сущностей доступны через list_datasets. |
compare_indicators | /api/v1/compare | Сравнить два показателя по странам. Любые два показателя базы (демография, миграция и беженцы, интернет и связь, ВВП, урбанизация, образование, экономика МВФ, цены на жильё, электричество, конфликты) за один год по всем странам или выбранным: точки X и Y, корреляции Пирсона и Спирмена, наблюдения (медианы для трети стран с наименьшим и наибольшим X), годы с данными, ссылка на вид «Все страны» на сайте. |
get_forecast_checks | /api/v1/forecast-checks | Прошлые прогнозы ООН, МВФ и Евростата против факта. Сверка прошлых выпусков прогноза ООН (WPP 1998–2022: население, рождения, смерти, рождаемость, младенческая смертность, чистая миграция, продолжительность жизни мужчин и женщин, возраст матери; source=components — почему ошибся прогноз населения: пересчёт старта, рождения, смерти, миграция) и прогнозов МВФ (WEO: рост ВВП, инфляция, долг, баланс бюджета, текущий счёт, безработица, ВВП на душу, население) с фактом по любой стране, а для стран Европы — прогнозов Евростата EUROPOP 2013–2025 (рождаемость, население, миграция, продолжительность жизни). Без location — сводка по всем странам: медианная ошибка и доли ошибок в каждую сторону. |
get_series | /api/v1/series | Временные ряды. Годовые ряды любых показателей стран и мира из list_indicators: демография и прогнозы, экономика, питание, здоровье, время людей, культура, земля, климат и технологии. Опубликованные наблюдения, обследования и модельные оценки сохраняют kind и временную базу источника; пропуски не заполняются. До 10 стран и 6 показателей за запрос, с единицами и первоисточниками. Месячные снимки на годовой оси имеют time_basis=last_published_month_in_year, observation_periods и observation_qualities по годам; текущий год не является полным годовым средним. Компании, игры, общины и другие сущности — через get_dataset. |
rank_countries | /api/v1/countries | Сравнить страны. Таблица 237 стран: последняя рождаемость и рождения, падение от пика, население 2024, прогноз ООН на 2100 год, медианный возраст, нагрузка пожилыми; сортировка, фильтр по региону и размеру. |
list_forecast_cases | /api/v1/forecasts | Случаи «прогноз против факта». Подробные случаи, где архивы официальных прогнозов сверены с фактом: демография (IPSS, статистика Кореи и Тайваня, ООН, SSA, ONS, Евростат, Destatis, ISTAT, Росстат, а также национальные прогнозы Австралии, Новой Зеландии, Бразилии, Чили, Колумбии, Аргентины, Перу и других), миграция, энергетика США (EIA: газ, нефть, уголь, CO₂, ветер, солнце, цена нефти), прогнозы ФРС, ЕЦБ и других центробанков, опрос профессиональных прогнозистов США (ФРБ Филадельфии), прогнозы роста Минфина и Управления бюджетной ответственности Великобритании и Еврокомиссии (Греция, Италия), бюджет США (CBO), мировая солнечная энергетика (EIA), цены нефти и газа (краткосрочные прогнозы Минэнерго США), допущения бюджетов президента США, прогнозы правительства Японии, допущения бюджета России (курс доллара, нефть Urals, рост ВВП, инфляция). У каждого — раздел (section). |
get_forecast_case | /api/v1/forecasts/{case_id} | Прогнозы и факт по случаю. Фактический ряд, все архивные прогнозы и разбор каждого: что ждали на последний год с фактом, расхождение, в каком году прогноз ждал сегодняшнего уровня. |
get_un2024_vs_actual | /api/v1/un2024-vs-actual | Прогноз ООН-2024 против фактических рождений. По странам с данными за 2024–2025 годы, где национальный ряд рождений совпадал с оценками ООН в общие годы: рождения по среднему варианту ООН (июль 2024) против национальной статистики, расхождение и выход за 95%-интервал. |
get_war_births | /api/v1/wars | Войны и рождения. Растёт ли рождаемость после войны и где из-за войн ошибались прогнозы. Каждая война на территории страны с 1955 года (UCDP/PRIO) против довоенного тренда и 10 мирных стран с той же рождаемостью: рождения, рождаемость и рождения на 1000 жителей во время войны, через 1–5 и 6–10 лет; большие войны до 1946 года (Первая и Вторая мировые и раньше) против стран, которые не воевали, по рождениям Human Mortality Database; медианы по всем войнам с тестом знаков; мировые войны (индекс рождений воевавших и нейтральных стран); рождения по месяцам после начала войны (Украина, Россия, Израиль, Армения, Азербайджан и другие, где есть месячные данные); регионы Колумбии, Мексики и Украины; ошибки прогнозов ООН в странах войны и их причины. С location — годы войн страны и её эпизоды. |
get_key_findings | /api/v1/findings | Главные выводы. Главные выводы Макроскопа, посчитанные из данных (те же, что на сайте). |
get_claims | /api/v1/claims | Сказано и сделано: заявления против фактов. Публичные обещания, цели и прогнозы с числом и сроком — главы правительств, министры, партии, законы и стратегии, центробанки, учёные, руководители компаний (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. Исход — сравнение чисел, а не оценка человека. |
get_sources | /api/v1/sources | Источники. Первоисточники: ООН WPP 2024, национальные ведомства, архивы прогнозов и поставщики единой базы, включая повседневную жизнь, культуру, платформы, землю и науку; национальные публикации можно отфильтровать по стране. Точное покрытие и исходные файлы — в get_series/get_dataset. |