# Search

Source: https://wire.ia.br/documentation/en/api/busca

> Find pages by title and text inside a vault.



```http
GET /vaults/{vault}/search?q={text}
```

Searches the title and text of the vault's pages. Returns up to 50 results. The search text can be up to 100 characters.

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

## Response with a regular token [#response-with-a-regular-token]

The search runs in the person's Google Drive and returns the pages it found:

```json
[
  { "id": "pa1k2m3n4o5p", "title": "Monday meeting", "kind": "pagina", "updatedAt": "2026-10-01T14:03:11.000Z" }
]
```

To read the text, request the page with `GET /vaults/{vault}/pages/{id}`.

## Response with a secure token [#response-with-a-secure-token]

In the copy for AI, each result already comes with a snippet around what was found:

```json
[
  { "id": "pa1k2m3n4o5p", "title": "Monday meeting", "trecho": "…review the budget before the meeting with…" }
]
```

## Tips [#tips]

* Encode the text in the URL (`encodeURIComponent` in JavaScript, `urllib.parse.quote` in Python).
* To scan the whole vault, list the pages once and keep the result. Don't run one search per page.
* Protected pages never show their content. With the "Show only the title" permission, they may appear in the results by title.