Search

Search notes (vector / keyword / hybrid)

Searches the current vault and returns one result per matching note (chunk hits are grouped by note, ranked by best chunk score). mode selects vector, keyword, or hybrid (default) retrieval, and results may be narrowed by tags or folder. Setting cross_vault searches across all of the user's vaults and requires the Pro plan (403 otherwise).

post/api/search

Request

  • Base URL: https://api.engram.page
  • URL: https://api.engram.page/api/search
  • Auth: HTTP bearer

Request body

created_afterstring date-time

Only notes whose frontmatter created date is at or after this ISO 8601 instant.

created_beforestring date-time

Only notes whose frontmatter created date is at or before this ISO 8601 instant.

cross_vaultboolean

Pro plan only.

diversitynumber

Result diversity (MMR). 0 = most relevant (default, tuned per plan); 1 = most varied.

folderstring
limitinteger

1..50, default 5

mode'keyword' | 'vector' | 'hybrid'
querystring required
tagsstring[]
typestring

Filter to notes whose frontmatter type equals this value (case-insensitive).

updated_afterstring date-time

Only notes whose frontmatter timestamp is at or after this ISO 8601 instant.

updated_beforestring date-time

Only notes whose frontmatter timestamp is at or before this ISO 8601 instant.

Example request

{
  "diversity": 0.3,
  "limit": 5,
  "mode": "hybrid",
  "query": "omega-3 dosage",
  "type": "Playbook"
}

Response

Results

Changes

No recorded changes to this operation across all 1 revision of this API.