# Busca

Fonte: https://wire.ia.br/documentation/api/busca

> Procurar páginas por título e texto dentro de um cofre.



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

Procura no título e no texto das páginas do cofre. Devolve até 50 resultados. O texto da busca pode ter até 100 caracteres.

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

## Resposta com token normal [#resposta-com-token-normal]

A busca roda no Google Drive da pessoa e devolve as páginas encontradas:

```json
[
  { "id": "pa1k2m3n4o5p", "title": "Reunião de segunda", "kind": "pagina", "updatedAt": "2026-10-01T14:03:11.000Z" }
]
```

Para ler o texto, peça a página com `GET /vaults/{cofre}/pages/{id}`.

## Resposta com token seguro [#resposta-com-token-seguro]

Na cópia para IA, cada resultado já vem com um trecho em volta do que foi encontrado:

```json
[
  { "id": "pa1k2m3n4o5p", "title": "Reunião de segunda", "trecho": "…revisar o orçamento antes da reunião com…" }
]
```

## Dicas [#dicas]

* Codifique o texto na URL (`encodeURIComponent` em JavaScript, `urllib.parse.quote` em Python).
* Para varrer o cofre inteiro, liste as páginas uma vez e guarde o resultado. Não faça uma busca por página.
* Páginas protegidas nunca aparecem com conteúdo. Com a permissão "Mostrar só o título", podem aparecer na lista de resultados pelo título.