API ReferenceCollections

Search Collection Advanced

Advanced search with comprehensive filtering and options.

This endpoint supports:

  • Metadata filtering using Qdrant’s native filter syntax
  • Pagination with offset and limit
  • Score threshold filtering
  • Query expansion strategies

Path parameters

readable_idstringRequired
The unique readable identifier of the collection to search

Headers

X-API-Keystring or nullOptional
X-Organization-IDstring or nullOptional

Request

This endpoint expects an object.
querystringRequired>=1 character<=1000 characters
The search query text
filterobject or nullOptional

Qdrant native filter for metadata-based filtering

offsetinteger or nullOptional>=0Defaults to 0
Number of results to skip
limitinteger or nullOptional>=1<=100Defaults to 20
Maximum number of results to return
score_thresholddouble or nullOptional>=0<=1
Minimum similarity score threshold
summarizeboolean or nullOptionalDefaults to false
Whether to summarize results
response_typeenumOptional

Type of response (raw or completion)

Allowed values:
expansion_strategyenumOptional
Query expansion strategy. Enhances recall by expanding the query with synonyms, related terms, and other variations, but increases latency.
Allowed values:

Response

Successful Response
resultslist of maps from strings to any
Array of search result objects containing the found documents, records, or data entities.
response_typeenum

Indicates whether results are raw search matches or AI-generated completions based on the found content.

Allowed values:
statusenum

Status of the search operation indicating the quality and availability of results:
• success: Search found relevant results matching your query
• no_relevant_results: Search completed but found no sufficiently relevant matches
• no_results: Search found no results at all, possibly indicating empty collections or very specific queries

Allowed values:
completionstring or null

AI-generated natural language answer when response_type is ‘completion’. This provides natural language answers to your query based on the content found across your connected data sources.

Errors