Paper documentación
API personal

Búsqueda

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

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.

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

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

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

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

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

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.

En esta página