{"uid":"cap_2r5BlPQVBbqNlP9moD2zV","slug":"memoryapi-semantic-document-query-ac375866","name":"MemoryAPI Semantic Document Query","description":"x402-powered APIs for AI agents: persistent semantic memory, document search, and translation. Pay per query in USDC on Base mainnet. MCP compatible.","url":"https://api.memoryapi.org/x402/docs/query","method":"GET","headers":{},"bodySchema":{"properties":{"input":{"required":["method"],"properties":{"method":{"enum":["GET"],"type":"string"}}}}},"responseSchema":{"example":{"count":1,"results":[{"content":"Payment is due net 30","similarity":0.88}],"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r6-TjJz8TFfscP-ptCHol","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a semantic similarity search over stored documents, returning the most relevant content chunks with similarity scores","exampleAgentPrompt":"Search my MemoryAPI knowledge base for documents about payment terms — I want to find anything semantically related to 'net 30 invoicing obligations' and show me the top result with its similarity score.","exampleUseCases":[{"title":"Customer support agent retrieving relevant policies","prompt":"Search my stored documentation for anything semantically similar to 'what's our return window' — I need to find relevant customer service policies to answer this support ticket quickly."},{"title":"Sales agent finding relevant case studies","prompt":"Look through my MemoryAPI knowledge base for content about 'enterprise deployment success' — I'm trying to find similar case studies or customer wins to share with this prospect."},{"title":"Research assistant finding topic-related notes","prompt":"Search my MemoryAPI for documents semantically related to 'machine learning model optimization' — I want to find all my research notes that connect to this concept for my analysis."}],"resultDescription":"Returns a JSON object with a success flag, the count of results found, and an array of result objects each containing the matched document content and a floating-point similarity score (e.g. 0.88). Payment is per-query at $0.01 USDC on Base mainnet via x402.","failureModes":["Payment not included or insufficient USDC — returns HTTP 402 Payment Required","Query parameter missing or malformed — returns 400 Bad Request","No documents stored in memory index — returns empty results array with count 0","Base mainnet transaction failure — payment rejected and query not processed","Rate limit exceeded — returns 429 Too Many Requests"],"whenToPreferThis":"Choose this endpoint when you need semantic (meaning-based) similarity search over a persistent document store rather than exact keyword matching. Ideal for AI agents that maintain a memory layer and need to retrieve contextually relevant stored content on demand. Best suited for per-query pay-as-you-go usage via x402/USDC rather than a subscription-based vector database service.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:32:57.255Z","isFirstParty":false}