{ "openapi": "3.1.0", "info": { "title": "Honeycomb — Dados abertos", "version": "1.0", "summary": "Indicadores de educação infantil no Brasil por região, UF e município.", "description": "API pública e sem cadastro, só de leitura. Cada página em https://honeycomb.app.br/dados tem um gêmeo aqui, no mesmo caminho com `/api/v1` no lugar de `/dados`. Só agregados por lugar, nunca por escola: células com menos de 3 escolas privadas saem como `null` com o campo `suprimido`. Versão dos dados: 2026.10.2. Documentação: https://honeycomb.app.br/dados/api", "license": { "name": "CC-BY-4.0", "identifier": "CC-BY-4.0" }, "contact": { "name": "Honeycomb", "url": "https://honeycomb.app.br/contato" } }, "externalDocs": { "description": "Documentação da API", "url": "https://honeycomb.app.br/dados/api" }, "servers": [ { "url": "https://honeycomb.app.br" } ], "security": [], "tags": [ { "name": "Índices", "description": "Conjuntos de dados disponíveis." }, { "name": "Panorama EI", "description": "Catálogos do Panorama da Educação Infantil." }, { "name": "Lugares", "description": "Indicadores de um lugar. O mesmo caminho da página, com `/api/v1` no lugar de `/dados`." } ], "paths": { "/api/v1": { "get": { "operationId": "listarConjuntos", "summary": "Conjuntos de dados", "tags": [ "Índices" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Conjuntos" } } } } } } }, "/api/v1/panorama-ei": { "get": { "operationId": "indicePanorama", "summary": "Índice do Panorama", "description": "Versão dos dados, links para os catálogos e a lista de lugares com página.", "tags": [ "Panorama EI" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IndicePanorama" } } } } } } }, "/api/v1/panorama-ei/geografias": { "get": { "operationId": "listarGeografias", "summary": "Todos os lugares", "description": "Todas as geografias, com ou sem página. Use para transformar um nome (\"Curitiba\") em `id` e `url_api`. Nomes repetidos entre UFs aparecem uma vez por UF.", "tags": [ "Panorama EI" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "versao_dados": { "type": "string" }, "geografias": { "type": "array", "items": { "$ref": "#/components/schemas/Geografia" } } } } } } } } } }, "/api/v1/panorama-ei/indicadores": { "get": { "operationId": "listarIndicadores", "summary": "Catálogo de indicadores", "description": "Definição, unidade, fonte, anos e níveis de cada indicador.", "tags": [ "Panorama EI" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "versao_dados": { "type": "string" }, "indicadores": { "type": "array", "items": { "$ref": "#/components/schemas/Indicador" } } } } } } } } } }, "/api/v1/panorama-ei/changelog": { "get": { "operationId": "listarVersoes", "summary": "Versões dos dados", "description": "Histórico de versões, com o SHA-256 de cada arquivo em lote.", "tags": [ "Panorama EI" ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "versoes": { "type": "array", "items": { "$ref": "#/components/schemas/Versao" } } } } } } } } } }, "/api/v1/panorama-ei/brasil": { "get": { "operationId": "lugarBrasil", "summary": "Brasil", "tags": [ "Lugares" ], "parameters": [ { "name": "formato", "in": "query", "required": false, "description": "`json` (padrão) ou `csv`. Também dá para pedir CSV com o cabeçalho `Accept: text/csv`.", "schema": { "type": "string", "enum": [ "json", "csv" ], "default": "json" } } ], "responses": { "200": { "description": "Indicadores do lugar.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lugar" }, "example": { "schema_version": "1.0", "id": "mun-4106902", "codigo_ibge": "4106902", "nivel": "municipio", "nome": "Curitiba", "uf": "PR", "url_html": "https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba?ref=api", "url_canonica": "https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba", "url_api": "https://honeycomb.app.br/api/v1/panorama-ei/municipio/pr/curitiba", "resumo": "Curitiba (PR) tem 241 escolas privadas puras com educação infantil e 197 conveniadas, com 33.906 matrículas na rede privada no Censo Escolar 2025 (INEP). Em número de escolas privadas puras com educação infantil, Curitiba fica em 1º lugar entre os 399 municípios do Paraná e em 11º entre os 5.571 do Brasil. Em 2020, eram 286 escolas privadas puras. A educação infantil do município soma 75.305 matrículas em 2025, em todas as redes. Em 2024 foram registrados 17.067 nascidos vivos (IBGE).", "contexto": [ "Variação do número de escolas privadas puras entre 2020 e 2025: -15,7% em Curitiba, -5,8% no Paraná e -2,7% no Brasil.", "Participação da rede privada nas matrículas de educação infantil em 2025: 45,0% em Curitiba, 21,4% no Paraná e 26,4% no Brasil.", "Média de alunos de educação infantil por escola privada pura em 2025: 78,1 em Curitiba, 72,2 no Paraná e 59,7 no Brasil." ], "ranking": { "indicador": "escolas_ei_pura", "ano": 2025, "posicoes": [ { "escopo": "uf-pr", "posicao": 1, "total": 399, "empate": false }, { "escopo": "br", "posicao": 11, "total": 5571, "empate": false } ] }, "indicadores": [ { "id": "escolas_ei_pura", "ano": 2025, "valor": 241, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 286, "variacao_pct": -15.7 } }, { "id": "mat_ei_pura", "ano": 2025, "valor": 18831, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 20802, "variacao_pct": -9.5 } }, { "id": "escolas_ei_conveniada", "ano": 2025, "valor": 197, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 103, "variacao_pct": 91.3 } }, { "id": "mat_ei", "ano": 2025, "valor": 75305, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 65630, "variacao_pct": 14.7 } }, { "id": "mat_ei_privada", "ano": 2025, "valor": 33906, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 29098, "variacao_pct": 16.5 } }, { "id": "media_alunos_ei_escola_pura", "ano": 2025, "valor": 78.1, "unidade": "alunos", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 72.7, "variacao_pct": 7.4 } }, { "id": "mat_ei_conveniada", "ano": 2025, "valor": 15075, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_ei_publica", "ano": 2025, "valor": 41399, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "escolas_ei_publica", "ano": 2025, "valor": 400, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_creche", "ano": 2025, "valor": 37212, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_pre", "ano": 2025, "valor": 38093, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "nascidos_vivos", "ano": 2024, "valor": 17067, "unidade": "crianças", "fonte": "IBGE, Estatísticas do Registro Civil (SIDRA 2609)", "comparacao": { "ano": 2020, "valor": 19779, "variacao_pct": -13.7 } }, { "id": "cobertura_creche", "ano": 2022, "valor": 51.4, "unidade": "%", "fonte": "INEP Censo Escolar 2022 × IBGE Censo Demográfico 2022" } ], "series": { "escolas_ei_pura": { "unidade": "escolas", "pontos": [ [ 2020, 286 ], [ 2021, 296 ], [ 2022, 274 ], [ 2023, 271 ], [ 2024, 262 ], [ 2025, 241 ] ] }, "mat_ei_pura": { "unidade": "matrículas", "pontos": [ [ 2020, 20802 ], [ 2021, 17400 ], [ 2022, 21281 ], [ 2023, 21194 ], [ 2024, 20656 ], [ 2025, 18831 ] ] }, "escolas_ei_conveniada": { "unidade": "escolas", "pontos": [ [ 2020, 103 ], [ 2021, 101 ], [ 2022, 126 ], [ 2023, 143 ], [ 2024, 166 ], [ 2025, 197 ] ] }, "mat_ei_conveniada": { "unidade": "matrículas", "pontos": [ [ 2020, 8296 ], [ 2021, 7929 ], [ 2022, 11491 ], [ 2023, 12804 ], [ 2024, 13859 ], [ 2025, 15075 ] ] }, "mat_ei_privada": { "unidade": "matrículas", "pontos": [ [ 2020, 29098 ], [ 2021, 25329 ], [ 2022, 32772 ], [ 2023, 33998 ], [ 2024, 34515 ], [ 2025, 33906 ] ] }, "mat_ei_publica": { "unidade": "matrículas", "pontos": [ [ 2020, 36532 ], [ 2021, 42539 ], [ 2022, 41205 ], [ 2023, 43503 ], [ 2024, 42733 ], [ 2025, 41399 ] ] }, "mat_ei": { "unidade": "matrículas", "pontos": [ [ 2020, 65630 ], [ 2021, 67868 ], [ 2022, 73977 ], [ 2023, 77501 ], [ 2024, 77248 ], [ 2025, 75305 ] ] }, "nascidos_vivos": { "unidade": "crianças", "pontos": [ [ 2020, 19779 ], [ 2021, 18628 ], [ 2022, 18448 ], [ 2023, 18161 ], [ 2024, 17067 ] ] } }, "notas": [ "Escola privada pura é a escola particular sem convênio com o poder público; conveniada é a escola particular com convênio com o poder público.", "O Censo Escolar 2025 mudou de formato; parte da variação 2024→2025 pode ser metodológica." ], "citacao": "Honeycomb / OSLO., Panorama da Educação Infantil no Brasil 2026, dados de Curitiba (PR). Disponível em https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba. Acesso em .", "licenca": { "id": "CC-BY-4.0", "url": "https://creativecommons.org/licenses/by/4.0/", "texto": "CC BY 4.0 (dados derivados); INEP e IBGE: dados abertos" }, "versao_dados": "2026.10.2", "gerado_em": "2026-10-29", "pai": "uf-pr", "relacionados": [ "mun-4113700", "mun-4115200", "mun-4104808", "mun-4119905", "mun-4108304", "mun-4125506", "mun-4105805", "mun-4109401" ] } }, "text/csv": { "schema": { "type": "string" }, "example": "geografia_id,indicador,ano,valor,unidade,suprimido,fonte\r\nmun-4106902,escolas_ei_pura,2025,241,escolas,,\"INEP, Censo Escolar 2025 (microdados)\"\r\n" } } }, "301": { "description": "Endereço antigo do lugar (renomeação); `Location` traz o atual." }, "400": { "description": "Valor de `formato` diferente de `json` ou `csv`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Erro" } } } }, "404": { "description": "Lugar sem página nesta versão dos dados. O corpo pode vir em HTML." } } } }, "/api/v1/panorama-ei/regiao/{regiao}": { "get": { "operationId": "lugarRegiao", "summary": "Região", "tags": [ "Lugares" ], "parameters": [ { "name": "regiao", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "norte", "nordeste", "sudeste", "sul", "centro-oeste" ] } }, { "name": "formato", "in": "query", "required": false, "description": "`json` (padrão) ou `csv`. Também dá para pedir CSV com o cabeçalho `Accept: text/csv`.", "schema": { "type": "string", "enum": [ "json", "csv" ], "default": "json" } } ], "responses": { "200": { "description": "Indicadores do lugar.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lugar" }, "example": { "schema_version": "1.0", "id": "mun-4106902", "codigo_ibge": "4106902", "nivel": "municipio", "nome": "Curitiba", "uf": "PR", "url_html": "https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba?ref=api", "url_canonica": "https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba", "url_api": "https://honeycomb.app.br/api/v1/panorama-ei/municipio/pr/curitiba", "resumo": "Curitiba (PR) tem 241 escolas privadas puras com educação infantil e 197 conveniadas, com 33.906 matrículas na rede privada no Censo Escolar 2025 (INEP). Em número de escolas privadas puras com educação infantil, Curitiba fica em 1º lugar entre os 399 municípios do Paraná e em 11º entre os 5.571 do Brasil. Em 2020, eram 286 escolas privadas puras. A educação infantil do município soma 75.305 matrículas em 2025, em todas as redes. Em 2024 foram registrados 17.067 nascidos vivos (IBGE).", "contexto": [ "Variação do número de escolas privadas puras entre 2020 e 2025: -15,7% em Curitiba, -5,8% no Paraná e -2,7% no Brasil.", "Participação da rede privada nas matrículas de educação infantil em 2025: 45,0% em Curitiba, 21,4% no Paraná e 26,4% no Brasil.", "Média de alunos de educação infantil por escola privada pura em 2025: 78,1 em Curitiba, 72,2 no Paraná e 59,7 no Brasil." ], "ranking": { "indicador": "escolas_ei_pura", "ano": 2025, "posicoes": [ { "escopo": "uf-pr", "posicao": 1, "total": 399, "empate": false }, { "escopo": "br", "posicao": 11, "total": 5571, "empate": false } ] }, "indicadores": [ { "id": "escolas_ei_pura", "ano": 2025, "valor": 241, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 286, "variacao_pct": -15.7 } }, { "id": "mat_ei_pura", "ano": 2025, "valor": 18831, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 20802, "variacao_pct": -9.5 } }, { "id": "escolas_ei_conveniada", "ano": 2025, "valor": 197, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 103, "variacao_pct": 91.3 } }, { "id": "mat_ei", "ano": 2025, "valor": 75305, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 65630, "variacao_pct": 14.7 } }, { "id": "mat_ei_privada", "ano": 2025, "valor": 33906, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 29098, "variacao_pct": 16.5 } }, { "id": "media_alunos_ei_escola_pura", "ano": 2025, "valor": 78.1, "unidade": "alunos", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 72.7, "variacao_pct": 7.4 } }, { "id": "mat_ei_conveniada", "ano": 2025, "valor": 15075, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_ei_publica", "ano": 2025, "valor": 41399, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "escolas_ei_publica", "ano": 2025, "valor": 400, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_creche", "ano": 2025, "valor": 37212, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_pre", "ano": 2025, "valor": 38093, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "nascidos_vivos", "ano": 2024, "valor": 17067, "unidade": "crianças", "fonte": "IBGE, Estatísticas do Registro Civil (SIDRA 2609)", "comparacao": { "ano": 2020, "valor": 19779, "variacao_pct": -13.7 } }, { "id": "cobertura_creche", "ano": 2022, "valor": 51.4, "unidade": "%", "fonte": "INEP Censo Escolar 2022 × IBGE Censo Demográfico 2022" } ], "series": { "escolas_ei_pura": { "unidade": "escolas", "pontos": [ [ 2020, 286 ], [ 2021, 296 ], [ 2022, 274 ], [ 2023, 271 ], [ 2024, 262 ], [ 2025, 241 ] ] }, "mat_ei_pura": { "unidade": "matrículas", "pontos": [ [ 2020, 20802 ], [ 2021, 17400 ], [ 2022, 21281 ], [ 2023, 21194 ], [ 2024, 20656 ], [ 2025, 18831 ] ] }, "escolas_ei_conveniada": { "unidade": "escolas", "pontos": [ [ 2020, 103 ], [ 2021, 101 ], [ 2022, 126 ], [ 2023, 143 ], [ 2024, 166 ], [ 2025, 197 ] ] }, "mat_ei_conveniada": { "unidade": "matrículas", "pontos": [ [ 2020, 8296 ], [ 2021, 7929 ], [ 2022, 11491 ], [ 2023, 12804 ], [ 2024, 13859 ], [ 2025, 15075 ] ] }, "mat_ei_privada": { "unidade": "matrículas", "pontos": [ [ 2020, 29098 ], [ 2021, 25329 ], [ 2022, 32772 ], [ 2023, 33998 ], [ 2024, 34515 ], [ 2025, 33906 ] ] }, "mat_ei_publica": { "unidade": "matrículas", "pontos": [ [ 2020, 36532 ], [ 2021, 42539 ], [ 2022, 41205 ], [ 2023, 43503 ], [ 2024, 42733 ], [ 2025, 41399 ] ] }, "mat_ei": { "unidade": "matrículas", "pontos": [ [ 2020, 65630 ], [ 2021, 67868 ], [ 2022, 73977 ], [ 2023, 77501 ], [ 2024, 77248 ], [ 2025, 75305 ] ] }, "nascidos_vivos": { "unidade": "crianças", "pontos": [ [ 2020, 19779 ], [ 2021, 18628 ], [ 2022, 18448 ], [ 2023, 18161 ], [ 2024, 17067 ] ] } }, "notas": [ "Escola privada pura é a escola particular sem convênio com o poder público; conveniada é a escola particular com convênio com o poder público.", "O Censo Escolar 2025 mudou de formato; parte da variação 2024→2025 pode ser metodológica." ], "citacao": "Honeycomb / OSLO., Panorama da Educação Infantil no Brasil 2026, dados de Curitiba (PR). Disponível em https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba. Acesso em .", "licenca": { "id": "CC-BY-4.0", "url": "https://creativecommons.org/licenses/by/4.0/", "texto": "CC BY 4.0 (dados derivados); INEP e IBGE: dados abertos" }, "versao_dados": "2026.10.2", "gerado_em": "2026-10-29", "pai": "uf-pr", "relacionados": [ "mun-4113700", "mun-4115200", "mun-4104808", "mun-4119905", "mun-4108304", "mun-4125506", "mun-4105805", "mun-4109401" ] } }, "text/csv": { "schema": { "type": "string" }, "example": "geografia_id,indicador,ano,valor,unidade,suprimido,fonte\r\nmun-4106902,escolas_ei_pura,2025,241,escolas,,\"INEP, Censo Escolar 2025 (microdados)\"\r\n" } } }, "301": { "description": "Endereço antigo do lugar (renomeação); `Location` traz o atual." }, "400": { "description": "Valor de `formato` diferente de `json` ou `csv`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Erro" } } } }, "404": { "description": "Lugar sem página nesta versão dos dados. O corpo pode vir em HTML." } } } }, "/api/v1/panorama-ei/uf/{uf}": { "get": { "operationId": "lugarUf", "summary": "Unidade da federação", "tags": [ "Lugares" ], "parameters": [ { "name": "uf", "in": "path", "required": true, "description": "Sigla em minúsculas.", "schema": { "type": "string", "enum": [ "ac", "al", "ap", "am", "ba", "ce", "df", "es", "go", "ma", "mt", "ms", "mg", "pr", "pb", "pa", "pe", "pi", "rn", "rs", "rj", "ro", "rr", "sc", "se", "sp", "to" ] } }, { "name": "formato", "in": "query", "required": false, "description": "`json` (padrão) ou `csv`. Também dá para pedir CSV com o cabeçalho `Accept: text/csv`.", "schema": { "type": "string", "enum": [ "json", "csv" ], "default": "json" } } ], "responses": { "200": { "description": "Indicadores do lugar.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lugar" }, "example": { "schema_version": "1.0", "id": "mun-4106902", "codigo_ibge": "4106902", "nivel": "municipio", "nome": "Curitiba", "uf": "PR", "url_html": "https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba?ref=api", "url_canonica": "https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba", "url_api": "https://honeycomb.app.br/api/v1/panorama-ei/municipio/pr/curitiba", "resumo": "Curitiba (PR) tem 241 escolas privadas puras com educação infantil e 197 conveniadas, com 33.906 matrículas na rede privada no Censo Escolar 2025 (INEP). Em número de escolas privadas puras com educação infantil, Curitiba fica em 1º lugar entre os 399 municípios do Paraná e em 11º entre os 5.571 do Brasil. Em 2020, eram 286 escolas privadas puras. A educação infantil do município soma 75.305 matrículas em 2025, em todas as redes. Em 2024 foram registrados 17.067 nascidos vivos (IBGE).", "contexto": [ "Variação do número de escolas privadas puras entre 2020 e 2025: -15,7% em Curitiba, -5,8% no Paraná e -2,7% no Brasil.", "Participação da rede privada nas matrículas de educação infantil em 2025: 45,0% em Curitiba, 21,4% no Paraná e 26,4% no Brasil.", "Média de alunos de educação infantil por escola privada pura em 2025: 78,1 em Curitiba, 72,2 no Paraná e 59,7 no Brasil." ], "ranking": { "indicador": "escolas_ei_pura", "ano": 2025, "posicoes": [ { "escopo": "uf-pr", "posicao": 1, "total": 399, "empate": false }, { "escopo": "br", "posicao": 11, "total": 5571, "empate": false } ] }, "indicadores": [ { "id": "escolas_ei_pura", "ano": 2025, "valor": 241, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 286, "variacao_pct": -15.7 } }, { "id": "mat_ei_pura", "ano": 2025, "valor": 18831, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 20802, "variacao_pct": -9.5 } }, { "id": "escolas_ei_conveniada", "ano": 2025, "valor": 197, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 103, "variacao_pct": 91.3 } }, { "id": "mat_ei", "ano": 2025, "valor": 75305, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 65630, "variacao_pct": 14.7 } }, { "id": "mat_ei_privada", "ano": 2025, "valor": 33906, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 29098, "variacao_pct": 16.5 } }, { "id": "media_alunos_ei_escola_pura", "ano": 2025, "valor": 78.1, "unidade": "alunos", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 72.7, "variacao_pct": 7.4 } }, { "id": "mat_ei_conveniada", "ano": 2025, "valor": 15075, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_ei_publica", "ano": 2025, "valor": 41399, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "escolas_ei_publica", "ano": 2025, "valor": 400, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_creche", "ano": 2025, "valor": 37212, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_pre", "ano": 2025, "valor": 38093, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "nascidos_vivos", "ano": 2024, "valor": 17067, "unidade": "crianças", "fonte": "IBGE, Estatísticas do Registro Civil (SIDRA 2609)", "comparacao": { "ano": 2020, "valor": 19779, "variacao_pct": -13.7 } }, { "id": "cobertura_creche", "ano": 2022, "valor": 51.4, "unidade": "%", "fonte": "INEP Censo Escolar 2022 × IBGE Censo Demográfico 2022" } ], "series": { "escolas_ei_pura": { "unidade": "escolas", "pontos": [ [ 2020, 286 ], [ 2021, 296 ], [ 2022, 274 ], [ 2023, 271 ], [ 2024, 262 ], [ 2025, 241 ] ] }, "mat_ei_pura": { "unidade": "matrículas", "pontos": [ [ 2020, 20802 ], [ 2021, 17400 ], [ 2022, 21281 ], [ 2023, 21194 ], [ 2024, 20656 ], [ 2025, 18831 ] ] }, "escolas_ei_conveniada": { "unidade": "escolas", "pontos": [ [ 2020, 103 ], [ 2021, 101 ], [ 2022, 126 ], [ 2023, 143 ], [ 2024, 166 ], [ 2025, 197 ] ] }, "mat_ei_conveniada": { "unidade": "matrículas", "pontos": [ [ 2020, 8296 ], [ 2021, 7929 ], [ 2022, 11491 ], [ 2023, 12804 ], [ 2024, 13859 ], [ 2025, 15075 ] ] }, "mat_ei_privada": { "unidade": "matrículas", "pontos": [ [ 2020, 29098 ], [ 2021, 25329 ], [ 2022, 32772 ], [ 2023, 33998 ], [ 2024, 34515 ], [ 2025, 33906 ] ] }, "mat_ei_publica": { "unidade": "matrículas", "pontos": [ [ 2020, 36532 ], [ 2021, 42539 ], [ 2022, 41205 ], [ 2023, 43503 ], [ 2024, 42733 ], [ 2025, 41399 ] ] }, "mat_ei": { "unidade": "matrículas", "pontos": [ [ 2020, 65630 ], [ 2021, 67868 ], [ 2022, 73977 ], [ 2023, 77501 ], [ 2024, 77248 ], [ 2025, 75305 ] ] }, "nascidos_vivos": { "unidade": "crianças", "pontos": [ [ 2020, 19779 ], [ 2021, 18628 ], [ 2022, 18448 ], [ 2023, 18161 ], [ 2024, 17067 ] ] } }, "notas": [ "Escola privada pura é a escola particular sem convênio com o poder público; conveniada é a escola particular com convênio com o poder público.", "O Censo Escolar 2025 mudou de formato; parte da variação 2024→2025 pode ser metodológica." ], "citacao": "Honeycomb / OSLO., Panorama da Educação Infantil no Brasil 2026, dados de Curitiba (PR). Disponível em https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba. Acesso em .", "licenca": { "id": "CC-BY-4.0", "url": "https://creativecommons.org/licenses/by/4.0/", "texto": "CC BY 4.0 (dados derivados); INEP e IBGE: dados abertos" }, "versao_dados": "2026.10.2", "gerado_em": "2026-10-29", "pai": "uf-pr", "relacionados": [ "mun-4113700", "mun-4115200", "mun-4104808", "mun-4119905", "mun-4108304", "mun-4125506", "mun-4105805", "mun-4109401" ] } }, "text/csv": { "schema": { "type": "string" }, "example": "geografia_id,indicador,ano,valor,unidade,suprimido,fonte\r\nmun-4106902,escolas_ei_pura,2025,241,escolas,,\"INEP, Censo Escolar 2025 (microdados)\"\r\n" } } }, "301": { "description": "Endereço antigo do lugar (renomeação); `Location` traz o atual." }, "400": { "description": "Valor de `formato` diferente de `json` ou `csv`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Erro" } } } }, "404": { "description": "Lugar sem página nesta versão dos dados. O corpo pode vir em HTML." } } } }, "/api/v1/panorama-ei/municipio/{uf}/{municipio}": { "get": { "operationId": "lugarMunicipio", "summary": "Município", "tags": [ "Lugares" ], "parameters": [ { "name": "uf", "in": "path", "required": true, "description": "Sigla da UF em minúsculas.", "schema": { "type": "string", "enum": [ "ac", "al", "ap", "am", "ba", "ce", "df", "es", "go", "ma", "mt", "ms", "mg", "pr", "pb", "pa", "pe", "pi", "rn", "rs", "rj", "ro", "rr", "sc", "se", "sp", "to" ] } }, { "name": "municipio", "in": "path", "required": true, "description": "Nome em minúsculas, sem acento, com hífens (`sao-jose-dos-pinhais`). Veja `slug` em /geografias.", "schema": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" } }, { "name": "formato", "in": "query", "required": false, "description": "`json` (padrão) ou `csv`. Também dá para pedir CSV com o cabeçalho `Accept: text/csv`.", "schema": { "type": "string", "enum": [ "json", "csv" ], "default": "json" } } ], "responses": { "200": { "description": "Indicadores do lugar.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Lugar" }, "example": { "schema_version": "1.0", "id": "mun-4106902", "codigo_ibge": "4106902", "nivel": "municipio", "nome": "Curitiba", "uf": "PR", "url_html": "https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba?ref=api", "url_canonica": "https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba", "url_api": "https://honeycomb.app.br/api/v1/panorama-ei/municipio/pr/curitiba", "resumo": "Curitiba (PR) tem 241 escolas privadas puras com educação infantil e 197 conveniadas, com 33.906 matrículas na rede privada no Censo Escolar 2025 (INEP). Em número de escolas privadas puras com educação infantil, Curitiba fica em 1º lugar entre os 399 municípios do Paraná e em 11º entre os 5.571 do Brasil. Em 2020, eram 286 escolas privadas puras. A educação infantil do município soma 75.305 matrículas em 2025, em todas as redes. Em 2024 foram registrados 17.067 nascidos vivos (IBGE).", "contexto": [ "Variação do número de escolas privadas puras entre 2020 e 2025: -15,7% em Curitiba, -5,8% no Paraná e -2,7% no Brasil.", "Participação da rede privada nas matrículas de educação infantil em 2025: 45,0% em Curitiba, 21,4% no Paraná e 26,4% no Brasil.", "Média de alunos de educação infantil por escola privada pura em 2025: 78,1 em Curitiba, 72,2 no Paraná e 59,7 no Brasil." ], "ranking": { "indicador": "escolas_ei_pura", "ano": 2025, "posicoes": [ { "escopo": "uf-pr", "posicao": 1, "total": 399, "empate": false }, { "escopo": "br", "posicao": 11, "total": 5571, "empate": false } ] }, "indicadores": [ { "id": "escolas_ei_pura", "ano": 2025, "valor": 241, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 286, "variacao_pct": -15.7 } }, { "id": "mat_ei_pura", "ano": 2025, "valor": 18831, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 20802, "variacao_pct": -9.5 } }, { "id": "escolas_ei_conveniada", "ano": 2025, "valor": 197, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 103, "variacao_pct": 91.3 } }, { "id": "mat_ei", "ano": 2025, "valor": 75305, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 65630, "variacao_pct": 14.7 } }, { "id": "mat_ei_privada", "ano": 2025, "valor": 33906, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 29098, "variacao_pct": 16.5 } }, { "id": "media_alunos_ei_escola_pura", "ano": 2025, "valor": 78.1, "unidade": "alunos", "fonte": "INEP, Censo Escolar 2025 (microdados)", "comparacao": { "ano": 2020, "valor": 72.7, "variacao_pct": 7.4 } }, { "id": "mat_ei_conveniada", "ano": 2025, "valor": 15075, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_ei_publica", "ano": 2025, "valor": 41399, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "escolas_ei_publica", "ano": 2025, "valor": 400, "unidade": "escolas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_creche", "ano": 2025, "valor": 37212, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "mat_pre", "ano": 2025, "valor": 38093, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)" }, { "id": "nascidos_vivos", "ano": 2024, "valor": 17067, "unidade": "crianças", "fonte": "IBGE, Estatísticas do Registro Civil (SIDRA 2609)", "comparacao": { "ano": 2020, "valor": 19779, "variacao_pct": -13.7 } }, { "id": "cobertura_creche", "ano": 2022, "valor": 51.4, "unidade": "%", "fonte": "INEP Censo Escolar 2022 × IBGE Censo Demográfico 2022" } ], "series": { "escolas_ei_pura": { "unidade": "escolas", "pontos": [ [ 2020, 286 ], [ 2021, 296 ], [ 2022, 274 ], [ 2023, 271 ], [ 2024, 262 ], [ 2025, 241 ] ] }, "mat_ei_pura": { "unidade": "matrículas", "pontos": [ [ 2020, 20802 ], [ 2021, 17400 ], [ 2022, 21281 ], [ 2023, 21194 ], [ 2024, 20656 ], [ 2025, 18831 ] ] }, "escolas_ei_conveniada": { "unidade": "escolas", "pontos": [ [ 2020, 103 ], [ 2021, 101 ], [ 2022, 126 ], [ 2023, 143 ], [ 2024, 166 ], [ 2025, 197 ] ] }, "mat_ei_conveniada": { "unidade": "matrículas", "pontos": [ [ 2020, 8296 ], [ 2021, 7929 ], [ 2022, 11491 ], [ 2023, 12804 ], [ 2024, 13859 ], [ 2025, 15075 ] ] }, "mat_ei_privada": { "unidade": "matrículas", "pontos": [ [ 2020, 29098 ], [ 2021, 25329 ], [ 2022, 32772 ], [ 2023, 33998 ], [ 2024, 34515 ], [ 2025, 33906 ] ] }, "mat_ei_publica": { "unidade": "matrículas", "pontos": [ [ 2020, 36532 ], [ 2021, 42539 ], [ 2022, 41205 ], [ 2023, 43503 ], [ 2024, 42733 ], [ 2025, 41399 ] ] }, "mat_ei": { "unidade": "matrículas", "pontos": [ [ 2020, 65630 ], [ 2021, 67868 ], [ 2022, 73977 ], [ 2023, 77501 ], [ 2024, 77248 ], [ 2025, 75305 ] ] }, "nascidos_vivos": { "unidade": "crianças", "pontos": [ [ 2020, 19779 ], [ 2021, 18628 ], [ 2022, 18448 ], [ 2023, 18161 ], [ 2024, 17067 ] ] } }, "notas": [ "Escola privada pura é a escola particular sem convênio com o poder público; conveniada é a escola particular com convênio com o poder público.", "O Censo Escolar 2025 mudou de formato; parte da variação 2024→2025 pode ser metodológica." ], "citacao": "Honeycomb / OSLO., Panorama da Educação Infantil no Brasil 2026, dados de Curitiba (PR). Disponível em https://honeycomb.app.br/dados/panorama-ei/municipio/pr/curitiba. Acesso em .", "licenca": { "id": "CC-BY-4.0", "url": "https://creativecommons.org/licenses/by/4.0/", "texto": "CC BY 4.0 (dados derivados); INEP e IBGE: dados abertos" }, "versao_dados": "2026.10.2", "gerado_em": "2026-10-29", "pai": "uf-pr", "relacionados": [ "mun-4113700", "mun-4115200", "mun-4104808", "mun-4119905", "mun-4108304", "mun-4125506", "mun-4105805", "mun-4109401" ] } }, "text/csv": { "schema": { "type": "string" }, "example": "geografia_id,indicador,ano,valor,unidade,suprimido,fonte\r\nmun-4106902,escolas_ei_pura,2025,241,escolas,,\"INEP, Censo Escolar 2025 (microdados)\"\r\n" } } }, "301": { "description": "Endereço antigo do lugar (renomeação); `Location` traz o atual." }, "400": { "description": "Valor de `formato` diferente de `json` ou `csv`.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Erro" } } } }, "404": { "description": "Lugar sem página nesta versão dos dados. O corpo pode vir em HTML." } } } }, "/api/v1/panorama-ei/municipio/{codigo_ibge}": { "get": { "operationId": "municipioPorCodigoIbge", "summary": "Município pelo código IBGE", "description": "Redireciona (301) para o endereço com o nome do município.", "tags": [ "Lugares" ], "parameters": [ { "name": "codigo_ibge", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^\\d{7}$" } } ], "responses": { "301": { "description": "`Location` aponta para `/municipio/{uf}/{municipio}`." }, "404": { "description": "Município sem página nesta versão dos dados. O corpo pode vir em HTML." } } } } }, "components": { "schemas": { "Erro": { "type": "object", "required": [ "erro", "mensagem" ], "properties": { "erro": { "type": "string" }, "mensagem": { "type": "string" } } }, "Licenca": { "type": "object", "properties": { "id": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "texto": { "type": "string" } } }, "Conjuntos": { "type": "object", "properties": { "nome": { "type": "string" }, "licenca": { "$ref": "#/components/schemas/Licenca" }, "documentacao": { "type": "string", "format": "uri" }, "openapi": { "type": "string", "format": "uri" }, "conjuntos": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "nome": { "type": "string" }, "descricao": { "type": "string" }, "versao_dados": { "type": "string" }, "url_html": { "type": "string", "format": "uri" }, "url_api": { "type": "string", "format": "uri" } } } } } }, "IndicePanorama": { "type": "object", "properties": { "nome": { "type": "string" }, "descricao": { "type": "string" }, "versao_dados": { "type": "string" }, "gerado_em": { "type": "string", "format": "date" }, "licenca": { "$ref": "#/components/schemas/Licenca" }, "url_html": { "type": "string", "format": "uri" }, "documentacao": { "type": "string", "format": "uri" }, "geografias": { "type": "string", "format": "uri" }, "indicadores": { "type": "string", "format": "uri" }, "changelog": { "type": "string", "format": "uri" }, "recursos": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "nome": { "type": "string" }, "nivel": { "type": "string", "enum": [ "pais", "regiao", "uf", "municipio", "bairro" ] }, "url_api": { "type": "string", "format": "uri" } } } } } }, "Geografia": { "type": "object", "required": [ "id", "nome", "nivel", "pai", "slug", "slugs_antigos" ], "properties": { "id": { "type": "string", "description": "Estável entre versões: `br`, `reg-s`, `uf-pr`, `mun-4106902`." }, "nome": { "type": "string" }, "nivel": { "type": "string", "enum": [ "pais", "regiao", "uf", "municipio", "bairro" ] }, "uf": { "type": "string", "description": "Sigla em maiúsculas (UFs e municípios)." }, "codigo_ibge": { "type": "string", "description": "7 dígitos, só municípios." }, "pai": { "type": [ "string", "null" ] }, "slug": { "type": "string" }, "slugs_antigos": { "type": "array", "items": { "type": "string" }, "description": "Nomes anteriores; redirecionam para o atual." }, "url_html": { "type": "string", "format": "uri", "description": "Só para lugares com página." }, "url_api": { "type": "string", "format": "uri", "description": "Só para lugares com página." } } }, "Indicador": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "escolas_ei_pura", "mat_ei_pura", "escolas_ei_conveniada", "mat_ei", "mat_ei_privada", "media_alunos_ei_escola_pura", "mat_ei_conveniada", "mat_ei_publica", "escolas_ei_publica", "mat_creche", "mat_pre", "nascidos_vivos", "cobertura_creche" ] }, "nome": { "type": "string" }, "definicao": { "type": "string" }, "unidade": { "type": "string" }, "fonte_primaria": { "type": "string" }, "tabela_origem": { "type": "string" }, "anos_disponiveis": { "type": "array", "items": { "type": "integer" } }, "niveis": { "type": "array", "items": { "type": "string", "enum": [ "pais", "regiao", "uf", "municipio", "bairro" ] } }, "sigilo": { "type": "boolean", "description": "Se a regra de sigilo (menos de 3 escolas) se aplica." }, "notas": { "type": "array", "items": { "type": "string" } } } }, "Celula": { "type": "object", "required": [ "id", "ano", "valor", "unidade", "fonte" ], "properties": { "id": { "type": "string", "enum": [ "escolas_ei_pura", "mat_ei_pura", "escolas_ei_conveniada", "mat_ei", "mat_ei_privada", "media_alunos_ei_escola_pura", "mat_ei_conveniada", "mat_ei_publica", "escolas_ei_publica", "mat_creche", "mat_pre", "nascidos_vivos", "cobertura_creche" ] }, "ano": { "type": "integer" }, "valor": { "type": [ "number", "null" ], "description": "Número sem formatação; percentuais de 0 a 100. `null` quando não divulgado." }, "suprimido": { "type": "string", "enum": [ "menos_de_3_escolas", "supressao_complementar" ], "description": "Presente só quando `valor` é `null`. `menos_de_3_escolas`: o valor descreveria 1 ou 2 escolas. `supressao_complementar`: omitido para que outro valor oculto não possa ser recalculado por subtração." }, "unidade": { "type": "string" }, "fonte": { "type": "string" }, "comparacao": { "type": "object", "properties": { "ano": { "type": "integer" }, "valor": { "type": [ "number", "null" ] }, "variacao_pct": { "type": [ "number", "null" ], "description": "`null` se um dos dois anos não é divulgado." } } } }, "examples": [ { "id": "mat_ei_conveniada", "ano": 2025, "valor": null, "unidade": "matrículas", "fonte": "INEP, Censo Escolar 2025 (microdados)", "suprimido": "menos_de_3_escolas" } ] }, "Serie": { "type": "object", "properties": { "unidade": { "type": "string" }, "pontos": { "type": "array", "description": "Pares `[ano, valor]`; `valor` é `null` quando não divulgado.", "items": { "type": "array", "prefixItems": [ { "type": "integer" }, { "type": [ "number", "null" ] } ], "minItems": 2, "maxItems": 2 } } } }, "Ranking": { "type": "object", "description": "Posição do lugar pelo número de escolas privadas puras com educação infantil.", "required": [ "indicador", "ano", "posicoes" ], "properties": { "indicador": { "type": "string" }, "ano": { "type": "integer" }, "posicoes": { "type": "array", "items": { "type": "object", "required": [ "escopo", "posicao", "total", "empate" ], "properties": { "escopo": { "type": "string", "description": "Geografia dentro da qual a posição foi calculada (`uf-pr`, `br`)." }, "posicao": { "type": "integer", "minimum": 1 }, "total": { "type": "integer", "description": "Número de lugares comparados." }, "empate": { "type": "boolean", "description": "Outro lugar tem o mesmo número (regra de competição)." } } } } } }, "Lugar": { "type": "object", "required": [ "schema_version", "id", "nivel", "nome", "url_canonica", "url_api", "resumo", "indicadores", "series", "citacao", "licenca", "versao_dados" ], "properties": { "schema_version": { "type": "string" }, "id": { "type": "string" }, "codigo_ibge": { "type": "string" }, "nivel": { "type": "string", "enum": [ "pais", "regiao", "uf", "municipio", "bairro" ] }, "nome": { "type": "string" }, "uf": { "type": "string" }, "url_html": { "type": "string", "format": "uri", "description": "Página do lugar, com `?ref=api`." }, "url_canonica": { "type": "string", "format": "uri", "description": "Endereço a citar." }, "url_api": { "type": "string", "format": "uri" }, "resumo": { "type": "string", "description": "Parágrafo pronto para citar, com ano e fonte. A primeira frase traz a resposta numérica." }, "contexto": { "type": "array", "items": { "type": "string" }, "description": "Frases de comparação com a UF e o Brasil, geradas a partir dos valores publicados." }, "ranking": { "$ref": "#/components/schemas/Ranking" }, "indicadores": { "type": "array", "items": { "$ref": "#/components/schemas/Celula" }, "description": "Valor mais recente de cada indicador." }, "series": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/Serie" }, "description": "Série anual por indicador." }, "notas": { "type": "array", "items": { "type": "string" } }, "citacao": { "type": "string", "description": "Texto de citação; só `` (data de acesso) fica para preencher." }, "licenca": { "$ref": "#/components/schemas/Licenca" }, "versao_dados": { "type": "string" }, "gerado_em": { "type": "string", "format": "date" }, "pai": { "type": [ "string", "null" ] }, "relacionados": { "type": "array", "items": { "type": "string" } } } }, "Versao": { "type": "object", "properties": { "versao_dados": { "type": "string" }, "data": { "type": "string", "format": "date" }, "descricao": { "type": "string" }, "arquivos": { "type": "array", "items": { "type": "object", "properties": { "caminho": { "type": "string" }, "sha256": { "type": "string" } } } } } } } } }