{"name":"Macroscope API","description":{"ru":"Открытые данные Макроскопа о демографии 237 стран: ООН World Population Prospects 2024 (оценки 1950–2023 и прогноз до 2100), национальная статистика 64 стран за 2015–2025, архивы официальных прогнозов, сверенные с фактом, и когортная модель сценариев. Без ключа и регистрации.","en":"Open Macroscope data on the demography of 237 countries: UN World Population Prospects 2024 (estimates 1950–2023, projections to 2100), national statistics of 64 countries for 2015–2025, archived official projections checked against actual data, and the cohort scenario model. No key or sign-up."},"data_date":"2026-10-01","start_here":["https://macroscope.reasonful.com/api/v1/locations?query=корея — код страны / country code","https://macroscope.reasonful.com/api/v1/locations/KOR — профиль страны / country profile","https://macroscope.reasonful.com/api/v1/series?location=KOR,JPN&indicator=tfr&from_year=2000 — ряды / series","https://macroscope.reasonful.com/api/v1/forecasts/jpn_births — прогнозы против факта / forecasts vs actual","https://macroscope.reasonful.com/api/v1/scenario?location=KOR&fertility=freeze — сценарий / scenario"],"endpoints":[{"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.reasonful.com/api/v1/locations?query=корея"},{"name":"get_location","method":"GET","path":"/api/v1/locations/{location}","title":"Профиль страны или региона / Location profile","description":"Главное о стране или регионе: последняя рождаемость и рождения с источником, пик рождений, ключевые значения ООН (1950–2100), национальная статистика с примечаниями, сверка с прогнозом ООН-2024, связанные случаи «прогноз против факта». / Key facts with sources, UN values 1950–2100, national statistics, 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.reasonful.com/api/v1/locations/KOR"},{"name":"list_indicators","method":"GET","path":"/api/v1/indicators","title":"Показатели и единицы / Indicators and units","description":"Список показателей (население, рождения, рождаемость, продолжительность жизни, миграция, медианный возраст, нагрузка пожилыми…) с единицами, годами и видами рядов. / Indicators with units, years and series kinds.","parameters":{"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.reasonful.com/api/v1/indicators"},{"name":"get_series","method":"GET","path":"/api/v1/series","title":"Временные ряды / Time series","description":"Ряды показателей по странам: оценки ООН 1950–2023, варианты прогноза ООН до 2100 года и национальная статистика со ссылками на источники. До 10 стран и 6 показателей за запрос. / Indicator time series: UN estimates, UN projection variants and national statistics with sources.","parameters":{"location":{"type":"string","description":"Одна или несколько через запятую: KOR,JPN / one or more, comma-separated","required":true},"indicator":{"type":"string","description":"Через запятую: births,tfr,population… (см. list_indicators) / comma-separated ids","required":true},"from_year":{"type":"integer","minimum":1950,"maximum":2100,"default":1950},"to_year":{"type":"integer","minimum":1950,"maximum":2100,"default":2100},"kind":{"type":"string","description":"Через запятую: estimate, projection_medium, projection_low, projection_lower95, projection_upper95, national или all; по умолчанию 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.reasonful.com/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.reasonful.com/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":"22 случая, где архивы официальных прогнозов (IPSS, статистика Кореи и Тайваня, ООН, SSA, ONS, Евростат, Destatis, ISTAT, Росстат…) сверены с фактом. / 22 cases of archived official projections checked against actual data.","parameters":{"lang":{"type":"string","enum":["ru","en"],"default":"ru","description":"Язык названий и пояснений / language of names and notes"}},"formats":["json"],"example":"https://macroscope.reasonful.com/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.reasonful.com/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":"По 47 странам с данными за 2024–2025 годы: рождения по среднему варианту ООН (июль 2024) против национальной статистики, расхождение и выход за 95%-интервал. / UN medium variant vs national births for 47 countries.","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.reasonful.com/api/v1/un2024-vs-actual"},{"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.reasonful.com/api/v1/findings"},{"name":"get_sources","method":"GET","path":"/api/v1/sources","title":"Источники / Sources","description":"Первоисточники: ООН WPP 2024, национальные статистические ведомства, архивы прогнозов; можно отфильтровать по стране. / Primary sources, optionally for one country.","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.reasonful.com/api/v1/sources?location=JPN"},{"name":"run_scenario","method":"GET","path":"/api/v1/scenario","title":"Посчитать сценарий / Run a scenario","description":"Когортная модель Макроскопа (та же, что в калькуляторе): население, рождения, возрастные группы, нагрузка пожилыми и медианный возраст с 2024 года до 2300-го при заданной рождаемости, смертности и миграции, плюс сравнение со средним вариантом ООН. Сценарий — арифметика, а не прогноз. / The calculator's cohort model: population, births, age groups, old-age dependency to 2300 under given assumptions, compared with the UN medium variant.","parameters":{"location":{"type":"string","description":"Страна или регион: название по-русски или по-английски, ISO3 (KOR), код региона (un-900 — мир) / country or region: name, ISO3 or region code","required":true},"fertility":{"type":"string","enum":["freeze","trend","custom","un","low"],"default":"freeze","description":"freeze — последний факт навсегда; trend — продолжение темпа последних лет до дна; custom — к цели к году; un / low — варианты ООН"},"fertility_target":{"type":"number","minimum":0.3,"maximum":3,"description":"Для custom: детей на женщину / target TFR"},"fertility_by_year":{"type":"integer","minimum":2026,"maximum":2300,"description":"Для custom: к какому году / target year"},"trend_window":{"type":"integer","minimum":3,"maximum":20,"default":10,"description":"Для trend: окно, лет"},"trend_floor":{"type":"number","minimum":0.3,"maximum":1.6,"default":0.6,"description":"Для trend: дно"},"mortality":{"type":"string","enum":["un","freeze","shift"],"default":"un","description":"un — как у ООН; freeze — уровень 2024; shift — сдвиг продолжительности жизни к 2100"},"mortality_shift":{"type":"number","minimum":-10,"maximum":10,"description":"Для shift: лет к 2100"},"migration":{"type":"string","enum":["un","zero","custom"],"default":"un"},"migration_per_year":{"type":"number","minimum":-5000,"maximum":5000,"description":"Для custom: нетто-миграция, тыс. в год"},"to_year":{"type":"integer","minimum":2030,"maximum":2300,"default":2100},"step":{"type":"integer","minimum":1,"maximum":50,"default":5,"description":"Шаг строк, лет / row step, years"},"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.reasonful.com/api/v1/scenario?location=KOR&fertility=freeze&to_year=2100"}],"mcp":{"url":"https://macroscope.reasonful.com/mcp","transport":"streamable-http (POST JSON-RPC 2.0, без авторизации / no auth)","tools":["search_locations","get_location","list_indicators","get_series","rank_countries","list_forecast_cases","get_forecast_case","get_un2024_vs_actual","get_key_findings","get_sources","run_scenario"],"note":"Те же операции как инструменты MCP: подключите адрес как коннектор в Claude, ChatGPT или другом клиенте MCP. / The same operations as MCP tools."},"openapi":"https://macroscope.reasonful.com/api/v1/openapi.json","llms_txt":"https://macroscope.reasonful.com/llms.txt","files":"https://macroscope.reasonful.com/data/catalog.json","site":"https://macroscope.reasonful.com/","conventions":{"language":"lang=ru (по умолчанию / default) или en","units":"население и рождения — тыс. (population and births in thousands); tfr — детей на женщину (children per woman)","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","scenario":"сценарий — арифметика при допущениях, не прогноз / a scenario is not a forecast"},"license":"UN WPP data: CC BY 3.0 IGO; national statistics: terms of each source","cite":"Macroscope (https://macroscope.reasonful.com) and the primary source named in the response"}