> ## 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: pesquisas e relatórios

> Todas as publicações do banco central da Colômbia, cerca de 5.700: os Borradores de Economía, os estudos de economia regional, os relatórios de política monetária e de estabilidade financeira, os relatórios da Junta Diretiva ao Congresso e os boletins regionais, com resumos, códigos JEL, departamentos, texto completo e uma cópia de cada arquivo.

O Banco de la República, o banco central da Colômbia, publica suas pesquisas e relatórios em um repositório institucional: cerca de 1.400 Borradores de Economía desde 1994, uns 350 documentos de trabalho sobre economia regional e urbana do seu Centro de Estudios Económicos Regionales, Ensayos sobre Política Económica desde 1982, o Informe de Política Monetaria trimestral (antes Informe sobre Inflación), o Reporte de Estabilidad Financiera, os relatórios da Junta Diretiva ao Congresso, os boletins econômicos regionais e os relatórios ICER de cada região, os relatórios de mercado de trabalho, de crédito e de mercados financeiros, e livros.

Cada publicação traz seus autores, data, série e número, resumos em espanhol e inglês, palavras-chave, códigos JEL, os departamentos da Colômbia que cobre (todos os boletins regionais os trazem), DOI e identificadores RePEc, o texto do seu documento principal e uma cópia idêntica byte a byte de cada arquivo publicado com ela: o PDF, sua versão em inglês, resumos, quadros, anexos, arquivos de dados e gráficos.

Busque por palavras (texto completo incluído), série, autor, código JEL, departamento ou data, e depois leia o texto de uma publicação pelo seu handle. O Banco de la República publica essas obras sob uma licença Creative Commons BY-NC-SA 4.0.

<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 publicações

`POST /co/banrep-research/publications-search/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma única busca sobre todas as publicações, por palavras, série, autor, código JEL, departamento ou data.

| Campo | Tipo | Notas |
| - | - | - |
| `query` | string | Palavras opcionais buscadas no título, nos resumos, nas palavras-chave, nos assuntos, nos autores e no texto completo, p. ex. `remesas`, `inflación de alimentos` ou `pobreza Chocó`. |
| `series` | enum | Série opcional, p. ex. `borradores`, `regional_working_papers`, `monetary_policy_report`, `financial_stability_report`, `board_report_to_congress` ou `regional_bulletin`. |
| `author` | string | Sobrenome opcional de um autor, com ou sem acentos, p. ex. `Ayala` ou `Ayala-García`. |
| `jel_code` | string | Código JEL opcional ou seu prefixo: `E52`, `E5` ou `R`. |
| `region` | string | Departamento opcional, p. ex. `Chocó` ou `La Guajira`. Os boletins regionais e os relatórios ICER o trazem. |
| `from_date` | string | Opcional: só publicações nesta data ou depois, `yyyy-mm-dd`. |
| `to_date` | string | Opcional: só publicações nesta data ou antes, `yyyy-mm-dd`. |
| `page` | integer | Número da página, começa em 1. Por padrão `1`. |
| `per_page` | integer | Resultados por página (1-50). Por padrão `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" }'
```

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[]`, da melhor correspondência à pior (sem busca, da mais recente à mais antiga). Cada resultado traz `id` (o handle, p. ex. `11430`), `handle_url`, `series` (p. ex. `borradores` ou `regional_bulletin`), `collection`, `series_title`, `number` (p. ex. `Borrador 1371`), `title` e `title_alternative` (o título no outro idioma), `authors` e `corporate_authors`, `date` (com a precisão publicada: `yyyy`, `yyyy-mm` ou `yyyy-mm-dd`), `published_on` e `year`, `language`, `type`, `abstract` (em espanhol), `abstract_en` e `abstract_en_truncated`, `summary` (o resumo não técnico mais longo dos documentos de trabalho recentes), `keywords` e `keywords_en`, `jel_codes` (cada um com `code` e `label`), `subjects`, `topic`, `regions` (os departamentos que uma publicação regional cobre), `branch`, `doi`, `repec_id`, `pages`, `license`, `portal_url`, `document_url` (a cópia da Croma do documento principal, idêntica byte a byte à que o Banco de la República publicou), `source_document_url`, `documents[]` (cada arquivo publicado com ela: versões em inglês, resumos, quadros, anexos, arquivos de dados e gráficos, cada um com `name`, `description`, `content_type`, `bytes`, `md5`, `document_url` e `source_document_url`), `text_status` (`ok`, `truncated` ou `missing`), `text_length` e `source_updated_at`.

<Note>
  Os resultados da busca não incluem o texto; `query` busca dentro dele. Para ler o texto use o endpoint Banco de la República Publication.
</Note>

## Uma publicação, com seu texto

`POST /co/banrep-research/publication/v1` <a className="dataset-pill" href="/pt/datasets">Dataset</a>

Uma publicação pelo seu handle, com o texto do seu documento principal.

| Campo | Tipo | Notas |
| - | - | - |
| `handle` | string | **Obrigatório.** O handle da publicação, o `id` de um resultado de busca (p. ex. `11430`), ou sua `handle_url`. |
| `offset` | integer | Primeiro caractere do texto a retornar. Envie o `next_offset` da resposta anterior para continuar lendo. Por padrão `0`. |
| `limit` | integer | Quantos caracteres do texto retornar. Por padrão `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" }'
```

Retorna `as_of`, `found`, `handle` e `publication`, que traz tudo o que a busca retorna mais `content`: uma janela sobre o texto do documento principal, com `text`, `offset`, `total_length`, `has_more` e `next_offset`. Cada resultado traz `id` (o handle, p. ex. `11430`), `handle_url`, `series` (p. ex. `borradores` ou `regional_bulletin`), `collection`, `series_title`, `number` (p. ex. `Borrador 1371`), `title` e `title_alternative` (o título no outro idioma), `authors` e `corporate_authors`, `date` (com a precisão publicada: `yyyy`, `yyyy-mm` ou `yyyy-mm-dd`), `published_on` e `year`, `language`, `type`, `abstract` (em espanhol), `abstract_en` e `abstract_en_truncated`, `summary` (o resumo não técnico mais longo dos documentos de trabalho recentes), `keywords` e `keywords_en`, `jel_codes` (cada um com `code` e `label`), `subjects`, `topic`, `regions` (os departamentos que uma publicação regional cobre), `branch`, `doi`, `repec_id`, `pages`, `license`, `portal_url`, `document_url` (a cópia da Croma do documento principal, idêntica byte a byte à que o Banco de la República publicou), `source_document_url`, `documents[]` (cada arquivo publicado com ela: versões em inglês, resumos, quadros, anexos, arquivos de dados e gráficos, cada um com `name`, `description`, `content_type`, `bytes`, `md5`, `document_url` e `source_document_url`), `text_status` (`ok`, `truncated` ou `missing`), `text_length` e `source_updated_at`.

<Note>
  A Croma guarda até 200.000 caracteres do texto de um documento; um mais longo diz `text_status: truncated`, e `document_url` entrega o documento completo. `content` é null quando `text_status` é `missing`.
</Note>

<Note>
  Um handle sob o qual o repositório não tem nenhuma publicação retorna `found: false` com HTTP 200, não um erro.
</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.