> ## 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.
# Banco de la República: investigaciones e informes
> Todas las publicaciones del banco central de Colombia, cerca de 5.700: los Borradores de Economía, los estudios de economía regional, los informes de política monetaria y de estabilidad financiera, los informes de la Junta Directiva al Congreso y los boletines regionales, con resúmenes, códigos JEL, departamentos, texto completo y una copia de cada archivo.
El Banco de la República, el banco central de Colombia, publica sus investigaciones e informes en un repositorio institucional: cerca de 1.400 Borradores de Economía desde 1994, unos 350 documentos de trabajo sobre economía regional y urbana de su Centro de Estudios Económicos Regionales, Ensayos sobre Política Económica desde 1982, el Informe de Política Monetaria trimestral (antes Informe sobre Inflación), el Reporte de Estabilidad Financiera, los informes de la Junta Directiva al Congreso, los boletines económicos regionales y los informes ICER de cada región, los reportes de mercado laboral, de crédito y de mercados financieros, y libros.
Cada publicación trae sus autores, fecha, serie y número, resúmenes en español e inglés, palabras clave, códigos JEL, los departamentos de Colombia que cubre (todos los boletines regionales los traen), DOI e identificadores RePEc, el texto de su documento principal y una copia idéntica byte a byte de cada archivo publicado con ella: el PDF, su versión en inglés, resúmenes, recuadros, anexos, archivos de datos y gráficos.
Busca por palabras (texto completo incluido), serie, autor, código JEL, departamento o fecha, y luego lee el texto de una publicación por su handle. El Banco de la República publica estas obras bajo una licencia Creative Commons BY-NC-SA 4.0.
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).
## Buscar publicaciones
`POST /co/banrep-research/publications-search/v1` Dataset
Una sola búsqueda sobre todas las publicaciones, por palabras, serie, autor, código JEL, departamento o fecha.
| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palabras opcionales que se buscan en el título, los resúmenes, las palabras clave, los temas, los autores y el texto completo, p. ej. `remesas`, `inflación de alimentos` o `pobreza Chocó`. |
| `series` | enum | Serie opcional, p. ej. `borradores`, `regional_working_papers`, `monetary_policy_report`, `financial_stability_report`, `board_report_to_congress` o `regional_bulletin`. |
| `author` | string | Apellido opcional de un autor, con o sin tildes, p. ej. `Ayala` o `Ayala-García`. |
| `jel_code` | string | Código JEL opcional o su prefijo: `E52`, `E5` o `R`. |
| `region` | string | Departamento opcional, p. ej. `Chocó` o `La Guajira`. Lo traen los boletines regionales y los informes ICER. |
| `from_date` | string | Opcional: solo publicaciones en esta fecha o después, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: solo publicaciones en esta fecha o antes, `yyyy-mm-dd`. |
| `page` | integer | Número de página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Resultados por página (1-50). Por defecto `10`. |
```bash theme={"dark"}
curl https://api.croma.run/co/banrep-research/publications-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "remesas", "series": "regional_working_papers" }'
```
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[]`, de la mejor coincidencia a la peor (sin búsqueda, de la más reciente a la más antigua). Cada resultado incluye `id` (el handle, p. ej. `11430`), `handle_url`, `series` (p. ej. `borradores` o `regional_bulletin`), `collection`, `series_title`, `number` (p. ej. `Borrador 1371`), `title` y `title_alternative` (el título en el otro idioma), `authors` y `corporate_authors`, `date` (con la precisión publicada: `yyyy`, `yyyy-mm` o `yyyy-mm-dd`), `published_on` y `year`, `language`, `type`, `abstract` (en español), `abstract_en` y `abstract_en_truncated`, `summary` (el resumen no técnico más largo de los documentos de trabajo recientes), `keywords` y `keywords_en`, `jel_codes` (cada uno con `code` y `label`), `subjects`, `topic`, `regions` (los departamentos que cubre una publicación regional), `branch`, `doi`, `repec_id`, `pages`, `license`, `portal_url`, `document_url` (la copia de Croma del documento principal, idéntica byte a byte a la que publicó el Banco de la República), `source_document_url`, `documents[]` (cada archivo publicado con ella: versiones en inglés, resúmenes, recuadros, anexos, archivos de datos y gráficos, cada uno con `name`, `description`, `content_type`, `bytes`, `md5`, `document_url` y `source_document_url`), `text_status` (`ok`, `truncated` o `missing`), `text_length` y `source_updated_at`.
Los resultados de búsqueda no incluyen el texto; `query` sí busca dentro de él. Para leer el texto usa el endpoint Banco de la República Publication.
## Una publicación, con su texto
`POST /co/banrep-research/publication/v1` Dataset
Una publicación por su handle, con el texto de su documento principal.
| Campo | Tipo | Notas |
| - | - | - |
| `handle` | string | **Obligatorio.** El handle de la publicación, el `id` de un resultado de búsqueda (p. ej. `11430`), o su `handle_url`. |
| `offset` | integer | Primer carácter del texto a devolver. Envía el `next_offset` de la respuesta anterior para seguir leyendo. Por defecto `0`. |
| `limit` | integer | Cuántos caracteres del texto devolver. Por defecto `200000`. |
```bash theme={"dark"}
curl https://api.croma.run/co/banrep-research/publication/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "handle": "11449" }'
```
Devuelve `as_of`, `found`, `handle` y `publication`, que trae todo lo que devuelve la búsqueda más `content`: una ventana sobre el texto del documento principal, con `text`, `offset`, `total_length`, `has_more` y `next_offset`. Cada resultado incluye `id` (el handle, p. ej. `11430`), `handle_url`, `series` (p. ej. `borradores` o `regional_bulletin`), `collection`, `series_title`, `number` (p. ej. `Borrador 1371`), `title` y `title_alternative` (el título en el otro idioma), `authors` y `corporate_authors`, `date` (con la precisión publicada: `yyyy`, `yyyy-mm` o `yyyy-mm-dd`), `published_on` y `year`, `language`, `type`, `abstract` (en español), `abstract_en` y `abstract_en_truncated`, `summary` (el resumen no técnico más largo de los documentos de trabajo recientes), `keywords` y `keywords_en`, `jel_codes` (cada uno con `code` y `label`), `subjects`, `topic`, `regions` (los departamentos que cubre una publicación regional), `branch`, `doi`, `repec_id`, `pages`, `license`, `portal_url`, `document_url` (la copia de Croma del documento principal, idéntica byte a byte a la que publicó el Banco de la República), `source_document_url`, `documents[]` (cada archivo publicado con ella: versiones en inglés, resúmenes, recuadros, anexos, archivos de datos y gráficos, cada uno con `name`, `description`, `content_type`, `bytes`, `md5`, `document_url` y `source_document_url`), `text_status` (`ok`, `truncated` o `missing`), `text_length` y `source_updated_at`.
Croma guarda hasta 200.000 caracteres del texto de un documento; uno más largo dice `text_status: truncated`, y `document_url` entrega el documento completo. `content` es null cuando `text_status` es `missing`.
Un handle bajo el cual el repositorio no tiene ninguna publicación devuelve `found: false` con HTTP 200, no un error.
Esquemas, todos los campos de respuesta y un playground interactivo.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.