{"slug":"mem0-cloud-saastemly-com-v3-memories-search-5ad40b","title":"Search your stored memories by meaning, like mem0's search","host":"mem0-cloud.saastemly.com","method":"POST","resource":"https://mem0-cloud.saastemly.com/v3/memories/search","category":"search","description":"Search your stored memories by meaning, like mem0's search: embeds the query and returns the closest memories with a relevance score from 0 to 1. Only memories stored under the same memory_key (your secret string; required) are searched. filters must name at least one of user_id, agent_id, app_id, r","price_listed":0.004,"price_asked":0.004,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":968,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"filters":{"user_id":"alice"},"memory_key":"mk_7f3a9c1e5b2d48a6b0c4e9d1","query":"where does the user live?","top_k":5},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"filters":{"description":"mem0 filters: at least one of user_id, agent_id, app_id, run_id, each a string, \"*\" or {\"in\": [up to 20 strings]}; AND lists of those. OR and NOT are not supported.","type":"object"},"memory_key":{"description":"Your secret: a random string of 16-256 characters that you generate once and keep (also accepted as the X-Memory-Key header). Memories are stored and searched only under its hash, so nobody who lacks it can read them, whatever user_id they send. Lose it and the memories are unreachable.","type":"string"},"query":{"description":"What to look for, in natural language (up to 500 characters)","type":"string"},"show_expired":{"description":"Include memories whose expiration_date has passed (default false)","type":"boolean"},"threshold":{"description":"Minimum relevance score, 0-1 (default 0.1; 0 disables)","type":"number"},"top_k":{"description":"How many memories to return, 1-100 (default 10)","type":"integer"}},"required":["memory_key","query","filters"]},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-03","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.004,"price_match":true,"latency_ms":968,"error":null}],"description_full":"Search your stored memories by meaning, like mem0's search: embeds the query and returns the closest memories with a relevance score from 0 to 1. Only memories stored under the same memory_key (your secret string; required) are searched. filters must name at least one of user_id, agent_id, app_id, run_id. Returns {results:[{id, memory, score, metadata, ...}]}.","last_updated":"2026-10-03T14:37:43.627Z","schemes":["exact"]}