Docs / Searching

Searching

aqoon uses hybrid search — a combination of semantic (meaning-based) and keyword search — to find the most relevant content across your documents.

There are several ways to search your knowledge base:

  • Claude (MCP) — Connect Claude Desktop or Claude Code via MCP. See MCP Setup.
  • ChatGPT — Create a Custom GPT with aqoon Actions. See ChatGPT Integration.
  • API — Send a POST /api/v1/search/ request with your API key. See API Reference.
  • Playground — Use the interactive Search Playground to test queries with your API key.

You can optionally filter by a specific collection to narrow results. The default result limit is 10 (configurable 1–50 via the API).

Understanding Results

Each result shows:

  • Document title — The source document
  • Collection — Which collection the document belongs to
  • Relevance — Results are ranked by how closely the content matches your query, with the most relevant results first
  • Content snippet — A preview of the matching text
  • Tags — Any tags assigned to the document

Search Tips

  • Be specific — "quarterly revenue 2025" works better than "revenue"
  • Use natural language — The semantic search understands meaning, so "how to reset a password" and "password reset instructions" both work
  • Filter by collection — If you know which collection has the answer, filtering speeds things up and improves relevance
  • Check indexed status — Only documents with an Indexed status appear in search results. If you just uploaded a document, wait for processing to complete.

What Gets Searched

Search covers all collections visible to you:

  • Collections you own
  • Public collections you've subscribed to

You won't see results from other users' private collections or public collections you haven't subscribed to.