Qdrant (Advanced)

Full Qdrant API — collections & points, with JSON expressions everywhere

Overview

This node provides advanced integration with the Qdrant vector search engine, allowing users to perform a variety of operations on Qdrant collections and points. Specifically, the "Count Points" operation counts the number of points in a specified collection that match an optional filter criteria.

Common scenarios for this node include:

  • Quickly determining how many data points meet certain conditions within a Qdrant collection.
  • Monitoring or auditing the size of filtered subsets of vector data.
  • Integrating point count queries into larger workflows for decision-making or reporting.

For example, you might use this node to count all points in a collection tagged with a specific category or attribute before performing further processing or analysis.

Properties

Name Meaning
Collection Name The name of the Qdrant collection to operate on. Supports expressions for dynamic input.
Filter (JSON) A JSON object defining filter criteria to select which points to count. Supports expressions.

Output

The output is a JSON object containing the count result from Qdrant. It typically looks like:

{
  "count": <number>
}

Where count is the number of points matching the filter in the specified collection.

No binary data output is produced by this operation.

Dependencies

  • Requires a valid Qdrant API endpoint URL and an API key credential configured in n8n.
  • Uses the official Qdrant JavaScript client library (@qdrant/js-client-rest) to communicate with the Qdrant service.

Troubleshooting

  • Missing Collection Name: The node will throw an error if the collection name is not provided. Ensure this property is set.
  • Invalid Filter JSON: If the filter JSON is malformed or invalid, the node may fail. Validate your JSON syntax.
  • API Connection Issues: Errors related to authentication or connectivity indicate problems with the Qdrant API credentials or network access.
  • Unsupported Operation Error: This occurs if an unsupported operation value is used; ensure "Count Points" is selected correctly.
  • Empty or Incorrect Filter: An empty filter {} counts all points, but incorrect filters may yield zero results or errors.

Links and References

Discussion