Knowledge Search
Search the Betterness knowledge library and combine with user data.
Tool
searchKnowledge(query?, type?, sort?, page?, pageSize?)
Examples
searchKnowledge(query: "vitamin D")
searchKnowledge(query: "sleep optimization", type: "VIDEO")
searchKnowledge(query: "thyroid", sort: "LATEST", pageSize: "20")
Combine with user data
Search alone returns generic content. The compelling pattern is to contextualize results with the user's own biomarkers:
searchBiomarkers(name: "Vitamin D")— get the user's actual valuessearchKnowledge(query: "vitamin D")— pull library content- Synthesize: cite the article and tie it to the user's value, e.g.:
Your last Vitamin D was 22 ng/mL (below the optimal 30-100 range). This article explains repletion strategies — focus on the dosing section since you're starting from a deficit.
Filtering
| Param | Values |
|---|---|
type | DOCUMENT or VIDEO (omit to return both) |
sort | LATEST (default), OLDEST, ASC, DESC |
pageSize | Default 10, max 50 |
Result fields
Each result includes externalId, title, type, authors, releaseDate, imageUrl (when available), and url (for video types).

