{"uid":"cap_e5BQmfStJL4agXKWHxCch","slug":"vector-namespace-semantic-search-5e7ea315","name":"Vector Namespace Semantic Search","description":"Search a namespace you indexed: the query is embedded on the same model and matched against your collection. Returns hits with score, text and metadata, plus latency.","url":"https://pearl-valium-stickers-upc.trycloudflare.com/v1/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"hits":{"type":"array"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":"down","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_QXtYFLhWoTeFxaGuzckei","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":"Embeds a query using the same model used at index time and returns ranked semantic search hits with scores, text, and metadata from a private vector collection.","exampleAgentPrompt":"Search my 'product-docs' namespace for anything relevant to 'how do I reset a user password' and return the top 5 hits with their scores and matched text.","exampleUseCases":[{"title":"Knowledge base Q&A retrieval","prompt":"Search my 'internal-kb' namespace for documents related to 'onboarding new employees' and show me the top 3 results with their relevance scores."},{"title":"RAG pipeline document lookup","prompt":"I'm building a RAG chatbot — query my 'legal-contracts' namespace with the question 'what are the termination clauses?' and give me the top 5 matching passages with metadata so I can feed them to the LLM."},{"title":"Support ticket context matching","prompt":"Search my 'support-history' vector collection for past tickets similar to 'customer can't log in after password reset' and return the top 4 hits with scores and any attached metadata."}],"resultDescription":"Returns an array of ranked hits, each containing a relevance/similarity score (cosine), the matched document text, and associated metadata. Also includes query latency in milliseconds.","failureModes":["Namespace not found — collection was never indexed or wrong name provided","Query embedding fails if the model is unavailable or overloaded on the local GPU","Empty results if the namespace has no documents or the query has no semantic overlap","Malformed input schema causes a 4xx error if 'hits' array or query text is missing","Slow response or timeout if the RTX 5090 is busy with a concurrent heavy task","Payment failure via x402 if USDC balance is insufficient or wallet is misconfigured"],"whenToPreferThis":"Choose this endpoint when you have already indexed documents into a private vector namespace on this service and need to perform semantic similarity search without sending data to a third-party cloud. Prefer it over generic vector DBs (Pinecone, Weaviate) when privacy is a concern since everything runs locally on the operator's hardware. It pairs naturally with the sibling index endpoint on the same host.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T13:19:39.238Z","isFirstParty":false,"canonicalSlug":"vector-namespace-semantic-search-5e7ea315"}