> ## 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.

# Indicadores do Banco Mundial

> Estatísticas de desenvolvimento da América Latina e do Caribe: cerca de 1.500 World Development Indicators das suas 42 economias desde 1960, de pobreza e desigualdade a trabalho, educação, saúde, renda, inclusão financeira e macroeconomia, mais as estimativas de pobreza e desigualdade do Banco Mundial por país e ano.

O Banco Mundial publica os World Development Indicators, sua coleção de
estatísticas de desenvolvimento comparáveis entre países, e a Poverty and
Inequality Platform, suas estimativas de pobreza e desigualdade a partir de
pesquisas domiciliares. A Croma mantém todos os valores WDI das 42 economias
da América Latina e do Caribe desde 1960, cerca de 1,3 milhão de valores em
cerca de 1.500 indicadores, e todas as estimativas de pobreza e desigualdade
que a plataforma publica, e os atualiza todo mês após cada publicação do Banco
Mundial.

Busque primeiro um indicador, por palavras ou por tema, e depois leia seus
valores por país e ano. O endpoint de pobreza responde a proporção de pessoas
abaixo das linhas internacionais de pobreza, o índice de Gini e a distribuição
do bem-estar, com a pesquisa por trás de cada número.

<Note>
  Os valores cobrem as 42 economias da América Latina e do Caribe como o Banco Mundial as agrupa, desde 1960. As estimativas de pobreza cobrem todos os países que o Banco Mundial reporta. Os números podem diferir dos institutos nacionais de estatística e de outras fontes internacionais, porque as medidas de bem-estar e os ajustes diferem: cite o Banco Mundial ao lado de cada número.
</Note>

<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 indicadores

`POST /global/world-bank/indicators-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Encontre o código do indicador de que precisa, por palavras ou por tema.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais do nome ou da definição do indicador, em inglês, p. ex. `gini`, `youth unemployment`. Todas devem aparecer. |
| `topic` | enum | Tema opcional, p. ex. `poverty`, `education`, `health`, `social_protection_labor`, `financial_sector`, `economy`, `gender`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-200). Por padrão `50`. |

```bash theme={"dark"}
curl https://api.croma.run/global/world-bank/indicators-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "gini", "topic": "poverty" }'
```

Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, por código. Cada indicador traz `indicator_code` (o que o endpoint de valores recebe), `indicator` (seu nome), `unit` (como o nome a indica, p. ex. `% of GDP`; null quando não indica), `topics[]`, `source_note` (a definição do Banco Mundial) e `source_organization` (quem produz os dados).

## Valores de um indicador

`POST /global/world-bank/indicator-values/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Valores por indicador, país e ano. Deixe `country_code` vazio para comparar todas as economias da região.

| Campo | Tipo | Notas |
| - | - | - |
| `indicator_code` | string | Código de indicador opcional, p. ex. `SI.POV.GINI` (índice de Gini), `SL.UEM.TOTL.ZS` (desemprego), `NY.GDP.PCAP.CD` (PIB per capita). |
| `country_code` | string | Código ISO 3166-1 de três letras opcional, p. ex. `COL`, `BRA`, `MEX`. |
| `year` | integer | Ano único opcional, p. ex. `2024`. Por padrão `0`. |
| `year_from` | integer | Primeiro ano opcional de um intervalo. Por padrão `0`. |
| `year_to` | integer | Último ano opcional de um intervalo. Por padrão `0`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-200). Por padrão `50`. |

```bash theme={"dark"}
curl https://api.croma.run/global/world-bank/indicator-values/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "indicator_code": "SI.POV.GINI",
        "country_code": "COL",
        "year_from": 2015
      }'
```

Retorna `as_of`, os filtros aplicados, `indicator`, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`. Cada valor traz `id` (país, indicador e ano), `country_code` (ISO 3166-1, três letras), `country`, `indicator_code`, `indicator`, `unit`, `year`, `value`, `decimals` (quantos o Banco Mundial mostra) e `obs_status` (a marca do Banco Mundial para uma estimativa, quando a coloca). Anos sem valor não aparecem. Ordenado por indicador, país e ano, do mais recente ao mais antigo. Com `indicator_code`, `indicator` traz sua definição.

## Pobreza e desigualdade

`POST /global/world-bank/poverty/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma linha por país, ano, cobertura e medida de bem-estar. Compare anos só dentro de um mesmo `comparable_spell`.

| Campo | Tipo | Notas |
| - | - | - |
| `country_code` | string | Código ISO 3166-1 de três letras opcional, p. ex. `COL`, `BRA`, `MEX`. |
| `year` | integer | Ano único opcional, p. ex. `2024`. Por padrão `0`. |
| `year_from` | integer | Primeiro ano opcional de um intervalo. Por padrão `0`. |
| `year_to` | integer | Último ano opcional de um intervalo. Por padrão `0`. |
| `reporting_level` | enum | Cobertura opcional: `national`, `urban` ou `rural`. A Argentina só tem pesquisas urbanas, então deixe vazio para ver todos os países. |
| `welfare_type` | enum | Medida de bem-estar opcional: `income` (renda, a maior parte da América Latina) ou `consumption` (consumo). |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-200). Por padrão `50`. |

```bash theme={"dark"}
curl https://api.croma.run/global/world-bank/poverty/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "country_code": "COL", "year_from": 2015 }'
```

Retorna `as_of`, os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`. Cada estimativa traz `id` (país, ano, cobertura e medida de bem-estar), `country_code`, `country`, `region_code`, `year`, `survey_year`, `survey_acronym`, `survey_coverage`, `reporting_level`, `welfare_type`, `comparable_spell` (compare anos só dentro de um), `headcount_300`, `headcount_420` e `headcount_830` (a proporção de pessoas abaixo de US\$ 3,00, 4,20 e 8,30 por dia, PPC 2021, de 0 a 1), `poverty_gap_300`, `poverty_gap_420`, `poverty_gap_830`, `gini` (de 0 a 1), `mean` e `median` (dólares PPC 2021 por dia por pessoa), `mld`, `polarization`, `deciles[]` (a participação de cada décimo no bem-estar, do mais pobre ao mais rico), `societal_poverty_line`, `population`, `is_interpolated`, `estimation_type` e `distribution_type`. Ordenado por país e ano, do mais recente ao mais antigo.

Fonte: Banco Mundial, World Development Indicators e Poverty and Inequality Platform, sob CC BY 4.0. A Croma reorganiza os dados nos campos acima; o Banco Mundial não endossa este serviço.

<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.