{"uid":"cap_cxX6dEcIlHPxfwnZ2IKy7","slug":"cluster-protocol-rerank-2efb0da0","name":"Cluster Protocol Rerank","description":"Liberation Engine for Internet Capital Market","url":"https://api.clusterprotocol.ai/v1/rerank?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"input":{"type":"object","required":["model","query","documents"],"properties":{"model":{"type":"string","description":"Reranker model slug"},"query":{"type":"string","description":"Search query"},"top_n":{"type":"integer","description":"Number of top results"},"documents":{"type":"array","items":{"type":"string"},"description":"Documents to rerank"}}},"output":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"document":{"type":"string"},"relevance_score":{"type":"number"}}}}}},"properties":{"input":{"required":["method"],"properties":{"method":{"enum":["POST"],"type":"string"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oOvpSE9p0lso0tjlwZI5H","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reranks a list of documents by relevance to a given search query, returning scored and ordered results","exampleAgentPrompt":"Rerank these 10 passages using the Cluster Protocol reranker with the query 'what are the side effects of ibuprofen?' and return the top 5 most relevant ones.","exampleUseCases":[{"title":"RAG pipeline context selection","prompt":"I have a list of 20 retrieved document chunks and the user asked 'how does transformer attention work?' — rerank them and give me the top 3 most relevant passages to send to the LLM."},{"title":"E-commerce search result ranking","prompt":"A user searched for 'waterproof hiking boots for winter' on our site and we got back 15 product descriptions — rerank them by relevance to that query so we show the best matches first."},{"title":"Legal document relevance filtering","prompt":"I have 30 contract clauses and need to find the ones most relevant to the question 'what are the termination conditions?' — can you rerank them and return the top 5 with their relevance scores?"}],"resultDescription":"An array of result objects, each containing the original document index, the document text, and a relevance_score float indicating how relevant that document is to the query. Results are ordered by descending relevance, with an optional top_n limit applied.","failureModes":["Missing required fields (model, query, or documents) returns a 400 validation error","Empty documents array causes an error or empty results","Unsupported or misspelled model slug returns a 404 or model-not-found error","Payment not provided or insufficient USDC balance causes a 402 payment required error","Very large document arrays may hit token or size limits","Documents that are too long may be truncated or rejected"],"whenToPreferThis":"Choose this endpoint when you need to rerank a set of candidate documents or passages by relevance to a specific query — especially in RAG pipelines, semantic search, or any retrieval system where initial recall quality needs to be boosted. It is preferable over embedding-based similarity alone when cross-encoder precision matters and you have a fixed candidate set to score.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T18:45:25.758Z","isFirstParty":false,"canonicalSlug":"cluster-protocol-rerank-2efb0da0"}