{"uid":"cap_qg7Bv_Lz5G9utWtAAgRUg","slug":"wicked-memory-semantic-search-db5d1e9e","name":"Wicked Memory Semantic Search","description":"Semantic search over an agent's own persistent memories (wallet-scoped). Free with a valid x-api-key.","url":"https://memory.wickedapi.com/memories/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Natural-language query (max 2000 chars)."},"tags":{"type":"string","description":"Comma-separated; memories must have ALL of these tags."},"as_of":{"type":"string","description":"ISO-8601 instant; search the versions valid at that moment."},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Max results (default 10)."},"created_after":{"type":"string","description":"ISO-8601 lower bound on creation time."},"created_before":{"type":"string","description":"ISO-8601 upper bound on creation time."},"include_superseded":{"type":"boolean","description":"Also search superseded (old) versions."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"required":["id","content","score"],"properties":{"id":{"type":"string"},"tags":{"type":"array"},"score":{"type":"number","description":"Cosine similarity computed at query time."},"content":{"type":"string"},"valid_from":{"type":"string"},"valid_until":{"type":["string","null"]}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JS7VqozbHZcICPbJAnT7d","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs semantic (vector) search over an AI agent's own persistent, wallet-scoped memory store using a natural-language query.","exampleAgentPrompt":"Search my memory for anything I previously saved about the client negotiation with Acme Corp — show me the top 5 most relevant results.","exampleUseCases":[{"title":"Recall past user preferences","prompt":"Search my memories for anything I've stored about this user's dietary preferences or food allergies — I need the top 3 most relevant ones."},{"title":"Retrieve project context before a meeting","prompt":"Pull up everything I've saved about the Orion project from my memories, filtered to notes created before January 1st 2025, and show me up to 10 results."},{"title":"Find tagged decision records","prompt":"Search my memories for anything tagged 'decision' and 'budget' that mentions Q3 spending — I need the most semantically relevant matches, up to 5 results."}],"resultDescription":"Returns a ranked list of memory objects, each containing a unique ID, the stored text content, a cosine similarity score (0–1) indicating relevance to the query, associated tags, and validity timestamps (valid_from and valid_until). Results are ordered by descending similarity score. Default limit is 10, maximum is 50.","failureModes":["Missing or invalid x-api-key returns an authentication error","Query parameter 'q' absent or exceeding 2000 characters causes a validation error","Invalid ISO-8601 format for as_of, created_after, or created_before returns a parsing error","No memories match the query — returns an empty data array (not an error)","Tag filter too restrictive — returns empty results when no memory has ALL specified tags","Payment failure or insufficient balance for $0.001 USDC per call (x402 protocol)","limit outside 1–50 range returns a validation error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to semantically recall its own previously stored, wallet-scoped memories using natural language — particularly when exact keyword search would be insufficient and relevance ranking by meaning is needed. It is ideal when you need to retrieve past context, decisions, user preferences, or notes that the agent has accumulated over time. Prefer this over general web search when the information is private and agent-specific, and over exact-match databases when the query intent matters more than keyword overlap. The tag and date filters make it superior when memories are organized or need temporal scoping.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:33:38.560Z","isFirstParty":false,"canonicalSlug":"wicked-memory-semantic-search-db5d1e9e"}