---
title: "Buscar en los boletines oficiales"
method: POST
path: "/boletines"
tags: ["Boletines"]
---

# Buscar en los boletines oficiales

`POST /boletines`

## Request

- Base URL: `https://boletinclaro.es/v1`
- URL: `https://boletinclaro.es/v1/boletines`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Búsqueda de solo lectura con cuerpo JSON, para consultas Unicode largas sin el límite de longitud de URL del proxy. Máximo 32 KiB de cuerpo; no admite parámetros en la URL. Todo lo que **no** es dinero: normativa, oposiciones, nombramientos, edictos y anuncios. Busca a la vez en las 25 gacetas oficiales — el BOE, el BORME, el DOUE y los diarios de las comunidades autónomas, las provincias forales vascas y las ciudades autónomas.

Las fuentes de subvenciones y licitaciones (BDNS, PLACSP, TED, EUFUNDING) **no** están aquí: para esas, usa `/oportunidades`.

## Request body

- object
  - `consulta` string, required
  - `fuentes` string[]
  - `limite` integer
  - `zona` string

## Response `200`

Entradas de boletín ordenadas por relevancia.

- RespuestaEntradas: Envoltorio común de las respuestas de lista. No hay paginación: una búsqueda semántica ordena por parecido, y la fila 400 de un ranking así no significa nada.
  - `busqueda` SearchMetadata
    - `candidatos_leidos` integer, required
    - `grupos_consulta` integer, required
    - `limite_candidatos` integer, required
    - `truncada` boolean, required: La selección de candidatos o el resultado se recortó; no es una exportación exhaustiva.
  - `consulta` string: La consulta tal y como se aplicó, ya recortada si venía por encima del máximo.
  - `resultados` Entrada[], required: Entradas encontradas, ordenadas por relevancia.
    - `ambito` 'nacional' | 'local': `nacional` cuando aplica a todo el país; `local` cuando va atada a lugares concretos.
    - `codigos_ubicacion` string[]: Jerarquía del INE de lo más concreto a lo más general (municipio, provincia, comunidad), para cruzarla con tus datos. Vacía en las entradas de ámbito nacional.
    - `enlace` string, uri: URL oficial de la fuente.
    - `fecha_fin` string, date: Cierre del plazo. Es lo que usamos para decidir si algo sigue abierto. Solo una parte de las convocatorias lo publica.
    - `fecha_inicio` string, date: Apertura del plazo, cuando la fuente la publica.
    - `fecha_publicacion` string, date: Cuándo salió en el boletín. AAAA-MM-DD.
    - `ficha` string, uri: Nuestra página del mismo elemento. **No guardes el identificador que aparece dentro de esta URL**: es la clave de nuestra página, no de la entrada.
    - `fuente` string, required: Código corto de la fuente: BDNS, PLACSP, TED, EUFUNDING, BOE, BOJA, DOG…
    - `identificador` string: Referencia propia de la fuente oficial. Estable en el único sitio que no controlamos nosotros.
    - `importe` number, double: Importe en la moneda de `moneda`. Cuando la fuente no publica importe el campo **no aparece**, en vez de venir a cero: así una suma tuya no se queda corta en silencio. Un cero que sí viene es un cero de verdad.
    - `moneda` string: Código ISO 4217.
    - `seccion` string: Sección del boletín, cuando la fuente la marca.
    - `tipo` 'subvencion' | 'licitacion' | 'boletin', required: Qué es la entrada. Se deriva de la fuente, así que no puede contradecir al filtro que la trajo.
    - `titulo` string, required: Título tal y como lo publica la fuente.
    - `ubicacion` string[]: Nombres completos de los lugares, para leerlos. Una entrada por lugar real, no una por nivel de la jerarquía. Se omiten si la geografía no está disponible; los códigos viajan igual.
  - `total` integer, required: Cuántas filas trae ESTA respuesta. No es cuántas hay en total.

## Other responses

- `400`: Un parámetro no vale.
- `401`: La clave de API no existe o está revocada.
- `403`: El plan del espacio de trabajo no incluye acceso a la API.
- `405`: La ruta existe pero no admite ese método HTTP.
- `429`: Has superado la ráfaga, el saldo mensual o diario del workspace, el tope por usuario o el máximo de perfiles y fichas.
- `500`: Fallo nuestro.
- `503`: Algo nuestro no está disponible. Incluye el caso en que no se pudo resolver «zona»: preferimos fallar a devolverte resultados sin filtrar.

---

[API](https://skmtc.dev/boletinclaro/apis/api-de-boletin-claro.md) · [All operations](https://skmtc.dev/boletinclaro/apis/api-de-boletin-claro/llms.txt) · [OpenAPI document](https://skmtc.dev/boletinclaro/apis/api-de-boletin-claro/revisions/0a0d93c76a75?raw)