# Búsqueda

Fuente: https://wire.ia.br/documentation/es/api/busca

> Buscar páginas por título y texto dentro de una bóveda.



```http
GET /vaults/{boveda}/search?q={texto}
```

Busca en el título y en el texto de las páginas de la bóveda. Devuelve hasta 50 resultados. El texto de la búsqueda puede tener hasta 100 caracteres.

```bash
curl "https://wire.ia.br/api/v1/vaults/principal/search?q=presupuesto" \
  -H "Authorization: Bearer $PAPER_TOKEN" \
  -H "X-Paper-Account: $PAPER_CUENTA"
```

## Respuesta con token normal [#respuesta-con-token-normal]

La búsqueda corre en el Google Drive de la persona y devuelve las páginas encontradas:

```json
[
  { "id": "pa1k2m3n4o5p", "title": "Reunión del lunes", "kind": "pagina", "updatedAt": "2026-10-01T14:03:11.000Z" }
]
```

Para leer el texto, pide la página con `GET /vaults/{boveda}/pages/{id}`.

## Respuesta con token seguro [#respuesta-con-token-seguro]

En la copia para IA, cada resultado ya trae un fragmento alrededor de lo que se encontró:

```json
[
  { "id": "pa1k2m3n4o5p", "title": "Reunión del lunes", "trecho": "…revisar el presupuesto antes de la reunión con…" }
]
```

## Consejos [#consejos]

* Codifica el texto en la URL (`encodeURIComponent` en JavaScript, `urllib.parse.quote` en Python).
* Para recorrer toda la bóveda, lista las páginas una vez y guarda el resultado. No hagas una búsqueda por página.
* Las páginas protegidas nunca muestran contenido. Con el permiso "Mostrar solo el título", pueden aparecer en los resultados por su título.