POST
/
v2
/
memories
/
search
/

Mem0 offers two versions of the search API: v1 and v2. Here’s how they differ:

Key difference between v1 and v2 search:

Filters: v2 allows you to apply filters to narrow down search results based on specific criteria. This includes support for complex logical operations (AND, OR) and comparison operators (IN, gte, lte, gt, lt, ne, icontains) for advanced filtering capabilities.

The v2 search API is more powerful and flexible, allowing for more precise memory retrieval.

Authorizations

Authorization
string
headerrequired

API key authentication. Prefix your Mem0 API key with 'Token '. Example: 'Token your_api_key'

Body

application/json
query
string
required

The query to search for in the memory.

filters
object
required

A dictionary of filters to apply to the search. Users can pass AND, OR, IN, gte, lte, gt, lt, ne, icontains operators for advanced filtering.

top_k
integer
default: 10

The number of top results to return.

fields
string[]

A list of field names to include in the response. If not provided, all fields will be returned.

rerank
boolean
default: false

Whether to rerank the memories.

org_name
string | null

The name of the organization associated with the memory.

project_name
string | null

The name of the project associated with the memory.

Response

200 - application/json
id
string
required

Unique identifier for the memory

memory
string
required

The content of the memory

input
object[]
required

The conversation input that was used to generate this memory

user_id
string
required

The identifier of the user associated with this memory

hash
string
required

A hash of the memory content

metadata
object | null

Additional metadata associated with the memory

created_at
string
required

The timestamp when the memory was created

updated_at
string
required

The timestamp when the memory was last updated