Search & queries - Coconut

Two ways to find pages: full-text search over their content, and metadata queries over their structured state.

Method & path	Purpose
`GET /search?q=`	Full-text search
`GET /search/metadata?filters=`	Metadata query
`GET /search/metadata/keys`	Metadata key discovery
`GET /search/metadata/values`	Metadata value discovery for one key

Metadata filter shape

filters is a JSON array of {key, op, value} objects, AND-ed together. Use orderBy and order=asc|desc to rank the results.

[
  {"key":"stage","op":"in","value":["sourcing","diligence"]},
  {"key":"conviction-score","op":"gte","value":0.7}
]

Supported operators

Operator	Matches when
`eq`, `neq`	the value equals, or does not equal, the given value
`gt`, `gte`, `lt`, `lte`	comparison over numbers and ISO-date strings
`contains`	the value is an array containing the given item
`in`, `not-in`	the value is any, or none, of an array of candidates. `not-in` requires the key to exist, like `neq`
`exists`, `missing`	the key is set, or not set (`value` is omitted)

The CLI exposes the same operators as --filter expressions, and the SDK as typed filter objects.

Full-text and metadata together

Full-text search answers “which pages talk about X”. Metadata queries answer “which pages are in state X”. See Search for how to combine them: full-text to find candidates, metadata to filter and rank.