> ## 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 del Banco Mundial

> Estadísticas de desarrollo de América Latina y el Caribe: unos 1.500 World Development Indicators de sus 42 economías desde 1960, de pobreza y desigualdad a trabajo, educación, salud, ingreso, inclusión financiera y macroeconomía, más las estimaciones de pobreza y desigualdad del Banco Mundial por país y año.

El Banco Mundial publica los World Development Indicators, su colección de
estadísticas de desarrollo comparables entre países, y la Poverty and
Inequality Platform, sus estimaciones de pobreza y desigualdad a partir de
encuestas de hogares. Croma conserva todos los valores WDI de las 42 economías
de América Latina y el Caribe desde 1960, cerca de 1,3 millones de valores en
unos 1.500 indicadores, y todas las estimaciones de pobreza y desigualdad que
publica la plataforma, y los actualiza cada mes tras cada publicación del
Banco Mundial.

Busca primero un indicador, por palabras o por tema, y luego lee sus valores
por país y año. El endpoint de pobreza responde la proporción de personas por
debajo de las líneas internacionales de pobreza, el índice de Gini y la
distribución del bienestar, con la encuesta detrás de cada cifra.

<Note>
  Los valores cubren las 42 economías de América Latina y el Caribe tal como las agrupa el Banco Mundial, desde 1960. Las estimaciones de pobreza cubren todos los países que reporta el Banco Mundial. Las cifras pueden diferir de las de las oficinas nacionales de estadística y de otras fuentes internacionales, porque las medidas de bienestar y los ajustes difieren: cita al Banco Mundial junto a cada cifra.
</Note>

<Note>
  La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
</Note>

## Buscar indicadores

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

Encuentra el código del indicador que necesitas, por palabras o por tema.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales del nombre o la definición del indicador, en inglés, p. ej. `gini`, `youth unemployment`. Deben aparecer todas. |
| `topic` | enum | Tema opcional, p. ej. `poverty`, `education`, `health`, `social_protection_labor`, `financial_sector`, `economy`, `gender`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-200). Por defecto `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" }'
```

Devuelve `as_of` (qué tan actualizados están los datos), los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`, por código. Cada indicador incluye `indicator_code` (lo que recibe el endpoint de valores), `indicator` (su nombre), `unit` (como lo indica el nombre, p. ej. `% of GDP`; null si no lo indica), `topics[]`, `source_note` (la definición del Banco Mundial) y `source_organization` (quién produce los datos).

## Valores de un indicador

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

Valores por indicador, país y año. Deja `country_code` vacío para comparar todas las economías de la región.

| Campo | Tipo | Notas |
| - | - | - |
| `indicator_code` | string | Código de indicador opcional, p. ej. `SI.POV.GINI` (índice de Gini), `SL.UEM.TOTL.ZS` (desempleo), `NY.GDP.PCAP.CD` (PIB per cápita). |
| `country_code` | string | Código ISO 3166-1 de tres letras opcional, p. ej. `COL`, `BRA`, `MEX`. |
| `year` | integer | Año único opcional, p. ej. `2024`. Por defecto `0`. |
| `year_from` | integer | Primer año opcional de un rango. Por defecto `0`. |
| `year_to` | integer | Último año opcional de un rango. Por defecto `0`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-200). Por defecto `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
      }'
```

Devuelve `as_of`, los filtros aplicados, `indicator`, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`. Cada valor incluye `id` (país, indicador y año), `country_code` (ISO 3166-1, tres letras), `country`, `indicator_code`, `indicator`, `unit`, `year`, `value`, `decimals` (cuántos muestra el Banco Mundial) y `obs_status` (la marca del Banco Mundial para una estimación, cuando la pone). Los años sin valor no aparecen. Ordenado por indicador, país y año, del más reciente al más antiguo. Con `indicator_code`, `indicator` trae su definición.

## Pobreza y desigualdad

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

Una fila por país, año, cobertura y medida de bienestar. Compara años solo dentro de un mismo `comparable_spell`.

| Campo | Tipo | Notas |
| - | - | - |
| `country_code` | string | Código ISO 3166-1 de tres letras opcional, p. ej. `COL`, `BRA`, `MEX`. |
| `year` | integer | Año único opcional, p. ej. `2024`. Por defecto `0`. |
| `year_from` | integer | Primer año opcional de un rango. Por defecto `0`. |
| `year_to` | integer | Último año opcional de un rango. Por defecto `0`. |
| `reporting_level` | enum | Cobertura opcional: `national`, `urban` o `rural`. Argentina solo tiene encuestas urbanas, así que déjalo vacío para ver todos los países. |
| `welfare_type` | enum | Medida de bienestar opcional: `income` (ingreso, la mayor parte de América Latina) o `consumption` (consumo). |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-200). Por defecto `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 }'
```

Devuelve `as_of`, los filtros aplicados, `total` y `total_is_exact`, `page`, `per_page`, `total_pages`, `count` y `results[]`. Cada estimación incluye `id` (país, año, cobertura y medida de bienestar), `country_code`, `country`, `region_code`, `year`, `survey_year`, `survey_acronym`, `survey_coverage`, `reporting_level`, `welfare_type`, `comparable_spell` (compara años solo dentro de uno), `headcount_300`, `headcount_420` y `headcount_830` (la proporción de personas por debajo de USD 3,00, 4,20 y 8,30 al día, PPA 2021, de 0 a 1), `poverty_gap_300`, `poverty_gap_420`, `poverty_gap_830`, `gini` (de 0 a 1), `mean` y `median` (dólares PPA 2021 al día por persona), `mld`, `polarization`, `deciles[]` (la participación de cada décimo en el bienestar, del más pobre al más rico), `societal_poverty_line`, `population`, `is_interpolated`, `estimation_type` y `distribution_type`. Ordenado por país y año, del más reciente al más antiguo.

Fuente: Banco Mundial, World Development Indicators y Poverty and Inequality Platform, bajo CC BY 4.0. Croma reorganiza los datos en los campos de arriba; el Banco Mundial no respalda este servicio.

<Card title="Referencia completa" icon="code" href="/es/api-reference/overview">
  Esquemas, todos los campos de respuesta y un playground interactivo.
</Card>


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