Paper documentação
API pessoal

Busca

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

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.

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

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

[
  { "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

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

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

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.

Nesta página