​
User

If you provided a userId while creating memories, you can filter by user:

curl https://api.supermemory.ai/v3/search?q=machine+learning&userId=user_123 \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

​
Document

Filter within a specific document:

curl https://api.supermemory.ai/v3/search?q=machine+learning&docId=doc_123 \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \

​
Metadata

Filter results using metadata conditions:

curl https://api.supermemory.ai/v3/search?q=machine+learning&filters={"AND":[{"key":"category","value":"technology","negate":false},{"filterType":"numeric","key":"readingTime","value":"5","negate":false,"numericOperator":"<="}]}&userId=user_123 \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \

​
Category

Filter by predefined categories:

curl https://api.supermemory.ai/v3/search?q=research+papers&categoriesFilter=["technology","science"] \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \