> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ICFES

> Resultados Saber 11 de 2010 a 2022, por escola e por município e estrato socioeconômico: estudantes e pontuações médias, global e por área.

O Instituto Colombiano para la Evaluación de la Educación (ICFES) aplica o Saber 11, o exame que todo estudante faz ao terminar o ensino médio. Estes são seus resultados publicados de 2010 a 2022, agregados de duas formas: por escola (cerca de 10.000 escolas por ano), e por município e o estrato socioeconômico que os estudantes informaram para seu domicílio. Cada grupo traz quantos estudantes fizeram o exame, cada um contado uma vez, e sua pontuação global média (0 a 500) e sua pontuação média em matemática, leitura crítica, ciências naturais, ciências sociais e inglês (0 a 100). O exame assumiu sua forma atual na segunda aplicação de 2014: antes dela só se publicam matemática e inglês, na escala do exame anterior, e não há pontuação global.

O ICFES publicou resultados até a segunda aplicação de 2022. Duas segundas aplicações faltam no que publicou, 2018-2 e 2021-2, então esses períodos não retornam nada.

Busque escolas por nome, código DANE, município, período ou setor; consulte o detalhamento por estrato por município, departamento, período ou estrato.

<Note>
  A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets).
</Note>

## Buscar resultados por escola

`POST /co/icfes/saber11-schools-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma linha por escola e período, do período mais recente ao mais antigo e, dentro de cada um, da maior pontuação global média à menor.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no nome da escola e em seu município. |
| `school_code` | string | Código DANE opcional da escola, 12 dígitos, p. ex. `111001000078`. |
| `territory_code` | string | Código DIVIPOLA opcional da localização da escola: 5 dígitos para um município (p. ex. `11001`, Bogotá), 2 dígitos para um departamento inteiro (p. ex. `05`). |
| `year` | integer | Ano opcional do exame, 2010 a 2022. `0` retorna todos os anos. Por padrão `0`. |
| `period` | string | Período opcional: `yyyy-1` (primeira aplicação) ou `yyyy-2` (segunda aplicação), p. ex. `2022-2`. |
| `school_sector` | enum | Setor opcional: `oficial` (pública) ou `no_oficial` (privada). |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-100). Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/icfes/saber11-schools-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "territory_code": "11001",
        "period": "2022-2",
        "school_sector": "oficial"
      }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `results[]`. Cada resultado traz `id`, `period`, `year`, `sitting`, `school_code` (DANE), `school_name`, `school_sector` (`oficial` ou `no_oficial`), `calendar`, `area`, `territory_code`, `territory_name`, `department_code`, `department_name`, `students` (cada estudante contado uma vez), `mean_global` (0 a 500), `mean_mathematics`, `mean_critical_reading`, `mean_natural_sciences`, `mean_social_studies` e `mean_english` (0 a 100 cada um).

<Note>
  Compare o que é comparável. A primeira aplicação de cada ano (`yyyy-1`) é pequena e em sua maioria de escolas privadas de calendário B, cujos estudantes pontuam muito acima da média nacional; a segunda (`yyyy-2`) é quase todo o país. O estrato é o que cada estudante informou para seu domicílio, e na segunda aplicação cerca da metade de quem informa estratos 5 e 6 estuda em escolas públicas e pontua bem abaixo dos colegas de escolas privadas, então as médias dos estratos 5 e 6 de um município podem ficar abaixo do estrato 4.
</Note>

## Resultados por estrato

`POST /co/icfes/saber11-strata-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma linha por município, estrato e período, do período mais recente ao mais antigo.

| Campo | Tipo | Notas |
| - | - | - |
| `territory_code` | string | Código DIVIPOLA opcional da localização da escola: 5 dígitos para um município (p. ex. `11001`, Bogotá), 2 dígitos para um departamento inteiro (p. ex. `05`). |
| `year` | integer | Ano opcional do exame, 2010 a 2022. `0` retorna todos os anos. Por padrão `0`. |
| `period` | string | Período opcional: `yyyy-1` (primeira aplicação) ou `yyyy-2` (segunda aplicação), p. ex. `2022-2`. |
| `stratum` | enum | Estrato opcional: `1` a `6`, `sin_estrato` (o domicílio não tem) ou `no_reportado` (sem resposta). |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-100). Por padrão `20`. |

```bash theme={"dark"}
curl https://api.croma.run/co/icfes/saber11-strata-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "territory_code": "11001", "period": "2022-2" }'
```

Retorna `as_of`, os filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` e `results[]`. Cada resultado traz `id`, `period`, `year`, `sitting`, `territory_code`, `territory_name`, `department_code`, `department_name`, `stratum`, `students` (cada estudante contado uma vez), `mean_global` (0 a 500), `mean_mathematics`, `mean_critical_reading`, `mean_natural_sciences`, `mean_social_studies` e `mean_english` (0 a 100 cada um).

<Note>
  Compare o que é comparável. A primeira aplicação de cada ano (`yyyy-1`) é pequena e em sua maioria de escolas privadas de calendário B, cujos estudantes pontuam muito acima da média nacional; a segunda (`yyyy-2`) é quase todo o país. O estrato é o que cada estudante informou para seu domicílio, e na segunda aplicação cerca da metade de quem informa estratos 5 e 6 estuda em escolas públicas e pontua bem abaixo dos colegas de escolas privadas, então as médias dos estratos 5 e 6 de um município podem ficar abaixo do estrato 4.
</Note>

<Card title="Referência completa" icon="code" href="/pt/api-reference/overview">
  Esquemas, todos os campos de resposta e um playground interativo.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.