{"uid":"cap_6m-K3iH8l7hNhrCNx5pZM","slug":"gedx402-vector-search-natural-language-query-dc60a418","name":"GEDX402 Vector Search (Natural Language Query)","description":"x402 workers ai. pay with usdc on base, polygon, arbitrum, world, or solana. no api keys.","url":"https://ged-x402-search.jvalamis.workers.dev/v1/search/query","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string"},"top_k":{"type":"integer"},"namespace":{"type":"string"},"return_metadata":{"type":"boolean"}}},"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":"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.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_L2HLhdvm9X9x-Ybp2nAbZ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs natural-language semantic search over a vector namespace, returning the top-K matching documents with scores and metadata.","exampleAgentPrompt":"Search my 'project-alpha' namespace for the top 5 documents most relevant to 'quarterly revenue trends in SaaS companies' and include any stored metadata.","exampleUseCases":null,"resultDescription":"A JSON object with a count of matches and an array of match objects, each containing a document ID, a similarity score (e.g. 0.91), and optionally the stored metadata including the original text.","failureModes":["Missing or invalid namespace returns empty results or error","query parameter absent causes 400 bad request","top_k outside range 1-50 may be rejected or clamped","Payment failure (insufficient USDC balance or unsupported chain) returns HTTP 402","Invalid or mismatched vector dimensions (must be 768) cause rejection","Namespace not found returns empty matches array"],"whenToPreferThis":"Use this endpoint when you need pay-per-call semantic search without managing API keys — ideal for serverless AI agents doing RAG retrieval, knowledge base lookups, or similarity search over pre-stored documents in an isolated namespace. Prefer over managed vector DBs when you want blockchain-native micropayment access (USDC on Base, Polygon, Arbitrum, World, or Solana) and no credential management overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:25.451Z","isFirstParty":false}