Search Collections

Search collections using free-text relevance matching. Returns a bounded relevance-ranked result set and does not return next_page. For deterministic chronological pagination, use GET /v2/collections.

POST /v2/collections/search

cURL

cURL

curl "https://api.mem.ai/v2/collections/search" \
     --header "Content-Type: application/json" \
     --header "Authorization: Bearer $MEM_API_KEY" \
     --data '{
         "query": "recipes"
     }'

200

{
  "request_id": "api-request-018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
  "results": [
    {
      "created_at": "2025-03-18T11:00:00Z",
      "description": "Saved recipes from around the web",
      "id": "018f8d0d-5a3c-7afc-8321-2f6f6e0fefab",
      "title": "Recipe Notes",
      "updated_at": "2025-04-22T16:12:34Z"
    }
  ],
  "total": 1
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

query · string | null

Optional text query for relevance matching across collections. If omitted, search can still return a bounded general set.

Response

200 - application/json

OK

request_id · string · required

Identifier for this API request. Useful for tracing and support.

results · CollectionSearchItemResponseSchema · object[] · required

Relevance-ranked collection results matching the search request.

Show child attributes

total · integer · required

Number of collections returned by this bounded search response.