{"uid":"cap_1MroVu5IbnZLHcw3FMWcX","slug":"molcloud-ai-rerank-764d429d","name":"MolCloud AI Rerank","description":"41 pay-per-request AI, search, headless browser, crypto alpha & memory APIs for autonomous agents settling in USDC on Base via x402 v2.","url":"https://api.molcloud.net/api/ai/rerank?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"topK":{"type":"integer","default":5,"description":"Number of top documents to return"},"query":{"type":"string","description":"Search query to rank documents against"},"documents":{"type":"array","items":{"type":"string"},"description":"Candidate text passages to rerank"}}},"responseSchema":{"type":"json","example":{"data":{"ranked":[{"index":0,"score":0.992}]},"status":"success","endpoint":"/api/ai/rerank"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IlOdFhnvmp2q2V2KlIq0r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reranks a list of candidate text passages by relevance to a given query, returning scored and ordered results.","exampleAgentPrompt":"Rerank these 8 passages against the query 'what are the health benefits of omega-3 fatty acids' and return the top 3 most relevant ones.","exampleUseCases":[{"title":"RAG pipeline relevance filtering","prompt":"I retrieved 20 chunks from my document store for the question 'how does transformer attention work' — can you rerank them and give me the top 5 most relevant ones?"},{"title":"Search result quality improvement","prompt":"I have these 10 web search snippets about 'best practices for Kubernetes security' — rerank them by relevance to that query and show me the top 3."},{"title":"Candidate answer selection for QA","prompt":"I have 6 candidate answer passages for the question 'what caused the 2008 financial crisis' — score and rank them so I know which one to surface to the user first."}],"resultDescription":"A JSON object containing a ranked array of objects, each with the original document index and a relevance score (e.g. 0.992). Only the top-K results are returned, sorted by descending score.","failureModes":["Empty documents array returns error or empty ranked list","topK larger than documents array length may return fewer results than requested","Very long passages may be truncated or cause latency spikes","Payment failure (insufficient USDC balance) returns HTTP 402 before processing","Malformed query or missing required fields returns validation error"],"whenToPreferThis":"Choose this endpoint when you need fast, pay-per-request semantic reranking of retrieved text passages without managing your own reranking model infrastructure. It is ideal for RAG pipelines, retrieval augmentation, or search result post-processing where you need relevance scores and can pay micro-amounts in USDC per call via x402. Prefer this over embedding-based cosine similarity when you want a dedicated cross-encoder-style relevance signal.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:40:49.877Z","isFirstParty":false,"canonicalSlug":"molcloud-ai-rerank-764d429d"}