Skip to main content
POST
/
v2
/
collections
/
search
cURL
curl "https://api.mem.ai/v2/collections/search" \
     --header "Content-Type: application/json" \
     --header "Authorization: Bearer $MEM_API_KEY" \
     --data '{
         "query": "recipes"
     }'
{
  "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",
      "note_count": 10,
      "title": "Recipe Notes",
      "updated_at": "2025-04-22T16:12:34Z"
    }
  ],
  "total": 1
}

Documentation Index

Fetch the complete documentation index at: https://docs.mem.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.

​
filter_by_created_after
string<date-time> | null

Optional inclusive lower bound for collection creation time (ISO 8601). The timestamp must include a timezone offset such as Z or +01:00.

Example:

"2025-04-01T14:30:45Z"

​
filter_by_created_before
string<date-time> | null

Optional inclusive upper bound for collection creation time (ISO 8601). The timestamp must include a timezone offset such as Z or +01:00.

Example:

"2025-04-30T23:59:59Z"

​
filter_by_updated_after
string<date-time> | null

Optional inclusive lower bound for collection update time (ISO 8601). The timestamp must include a timezone offset such as Z or +01:00.

Example:

"2025-04-01T14:30:45Z"

​
filter_by_updated_before
string<date-time> | null

Optional inclusive upper bound for collection update time (ISO 8601). The timestamp must include a timezone offset such as Z or +01:00.

Example:

"2025-04-30T23:59:59Z"

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.

​
total
integer
required

Number of collections returned by this bounded search response.