{"uid":"cap_MXTVDn5PggrZbyTwLR4cr","slug":"mem0-cloud-memory-search-4bfe78a6","name":"Mem0 Cloud Memory 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, run_id. Returns {results:[{id, memory, score, metadata, ...}]}.","url":"https://mem0-cloud.saastemly.com/v3/memories/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"What to look for, in natural language (up to 500 characters)"},"top_k":{"type":"integer","description":"How many memories to return, 1-100 (default 10)"},"filters":{"type":"object","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."},"threshold":{"type":"number","description":"Minimum relevance score, 0-1 (default 0.1; 0 disables)"},"memory_key":{"type":"string","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."},"show_expired":{"type":"boolean","description":"Include memories whose expiration_date has passed (default false)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PW7hOQ8AEBMS__5ZR1oDN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Semantic search over stored memories using embedding similarity, returning the closest matches with relevance scores filtered by a secret memory key and entity identifiers.","exampleAgentPrompt":"Search my Mem0 memories for anything related to 'dietary preferences' for user_id 'user_abc123' — return the top 5 results with a relevance threshold of 0.3, using my memory key 'mK9xR2pL7qT4wN6vB8dY1cZ3'.","exampleUseCases":[{"title":"Personalized assistant context retrieval","prompt":"Before responding to this user, search my stored memories for anything about 'coffee preferences and morning routines' for user_id 'user_42' — give me the top 10 most relevant memories above a 0.2 relevance score."},{"title":"Agent recall for ongoing project","prompt":"Look up what my agent has remembered about 'project deadlines and milestones' for agent_id 'planner_agent_01' and give me the top 5 closest matches using my memory key 'zP8mQ3nL5wX2rT7vC9bK4dY6'."},{"title":"Session-scoped memory lookup","prompt":"Find any memories about 'user onboarding steps completed' for run_id 'session_789xyz' — I want everything with a relevance score above 0.4, up to 15 results."}],"resultDescription":"Returns a JSON object with a 'results' array, each element containing: memory id, memory text, relevance score (0–1), metadata fields, and any expiration or entity tagging. Results are ranked by semantic similarity to the query, filtered by the provided entity identifiers and minimum threshold.","failureModes":["Missing or invalid memory_key causes no results or unauthorized error","Filters object missing all of user_id/agent_id/app_id/run_id returns a validation error","Query string exceeding 500 characters is rejected","top_k outside 1–100 range causes a parameter error","Threshold set too high returns an empty results array","Memory key loss makes stored memories permanently unreachable","Expired memories excluded by default unless show_expired is true"],"whenToPreferThis":"Choose this endpoint when you need to semantically retrieve previously stored facts or memories for a specific user, agent, app, or session — especially when keyword search is insufficient and meaning-based similarity ranking is needed. Prefer it over general vector search services when the data was stored via the companion Mem0 Cloud add endpoint and access is controlled by a shared memory_key secret.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T00:31:52.538Z","isFirstParty":false,"canonicalSlug":"mem0-cloud-memory-search-4bfe78a6"}