{"uid":"cap_9w3YVJ0cCnLSOrD3jYihH","slug":"gedx402-vector-search-query-64dc738b","name":"GEDX402 Vector Search Query","description":"x402 workers ai. pay with usdc on base, polygon, arbitrum, world, or solana. no api keys.","url":"https://search.gedx402.com/v1/search/query","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"Natural-language search query."},"top_k":{"type":"integer","description":"Max results (1-50)."},"namespace":{"type":"string","description":"Agent collection id (2-64 chars). Isolates vectors per agent or project."},"return_metadata":{"type":"boolean","description":"Include stored metadata in matches."}}},"responseSchema":{"type":"json","example":{"count":1,"matches":[{"id":"doc-1","score":0.91,"metadata":{"text":"..."}}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Gh1R2XxU2mHaYSeuF9LdU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs semantic vector search over a named namespace, returning ranked document matches with optional metadata, paid per-query via USDC on multiple chains","exampleAgentPrompt":"Search my 'customer-support' namespace for the top 5 documents most relevant to 'how do I reset my password', and include their stored metadata in the results.","exampleUseCases":[{"title":"Agent knowledge base lookup during conversations","prompt":"Search my 'agent-memory' namespace for documents related to what the user just asked, return the top 3 most relevant matches so I can ground my response in our stored knowledge."},{"title":"Customer support ticket resolution assistant","prompt":"Find the most similar past support tickets and resolutions from my 'resolved-cases' namespace for this new customer issue, so I can suggest the best solution quickly."},{"title":"Real-time product recommendation engine","prompt":"Search my 'product-catalog' namespace for items semantically similar to what the customer is asking about, and return the top 10 with their metadata so I can make personalized suggestions."}],"resultDescription":"A JSON object with a count field and a matches array; each match includes a document ID, a floating-point similarity score (e.g. 0.91), and optionally a metadata object containing the original text and any stored fields.","failureModes":["Payment not received or insufficient USDC — HTTP 402 returned before query executes","Namespace not found or empty — returns count 0 with empty matches array","top_k out of range (must be 1-50) — validation error or clamped result","Query string missing or empty — 400 bad request","Chain/network payment failure causing transaction timeout","Namespace string too short (<2) or too long (>64 chars) — validation error"],"whenToPreferThis":"Choose this endpoint when you need pay-per-query semantic vector search without provisioning API keys or managing embedding infrastructure — especially in agentic workflows that already handle USDC micropayments on Base, Polygon, Arbitrum, World, or Solana. Ideal for agents needing to query isolated per-project or per-agent document namespaces at low cost ($0.02/call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:35:25.997Z","isFirstParty":false}