Run a Qdrant hybrid search combining dense and sparse vectors with prefetch + RRF fusion via the Query API

domain: qdrant.tech · 8 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Auth: api-key header if API-key auth is enabled (always required on Qdrant Cloud).
  2. Send one POST /collections/{collection_name}/points/query with a prefetch array (one sub-query per vector type) and a top-level fusing query
  3. Each prefetch entry has its own query, using (named vector), and limit: {"prefetch": [{"query": {"indices": [1,42], "values": [0.22,0.8]}, "using": "sparse", "limit": 20}, {"query": [0.01,0.45,0.67], "using": "dense", "limit": 20}], "query": {"rrf": {}}, "limit": 10}
  4. curl: curl -X POST 'http://localhost:6333/collections/{collection_name}/points/query' -H 'api-key: <API_KEY>' -H 'Content-Type: application/json' -d '{"prefetch":[{"query":{"indices":[1,42],"values":[0.22,0.8]},"using":"sparse","limit":20},{"query":[0.01,0.45,0.67],"using":"dense","limit":20}],"query":{"rrf":{}},"limit":10}'
  5. As of v1.17.0, tune RRF with an explicit constant and per-prefetch weights: "query": {"rrf": {"k": 60, "weights": [3.0, 1.0]}} (weights ordered to match the prefetch array)
  6. Alternative fusion: Distribution-Based Score Fusion via "query": {"fusion": "dbsf"} — normalizes each retriever's score distribution instead of rank position
  7. For multi-stage retrieval (cheap prefetch, then rescore), nest prefetch objects inside prefetch with the final rescoring query at the top level
  8. Official docs: https://qdrant.tech/documentation/search/hybrid-queries/ ; https://api.qdrant.tech/api-reference/search/query-points

Known gotchas

Related routes

Qdrant: create a collection and perform a vector search
qdrant.tech/documentation · 6 steps · unrated
Run hybrid search combining vector and full-text results in MongoDB Atlas using $rankFusion
mongodb.com · 5 steps · unrated
Tune Spark Adaptive Query Execution (AQE) for skewed joins and dynamic partition pruning
dataeng-general · 5 steps · unrated

Give your agent this knowledge — and 17,800+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans