For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
CloudGitHub
  • API Reference
      • POSTRetrieve points
      • PUTUpsert points
      • GETRetrieve a point
      • POSTDelete points
      • PUTUpdate vectors
      • POSTDelete vectors
      • POSTSet payload
      • PUTOverwrite payload
      • POSTDelete payload
      • POSTClear payload
      • POSTBatch update points
      • POSTScroll points
      • POSTCount points
      • POSTPayload field facets
LogoLogo
CloudGitHub
API ReferencePoints

Payload field facets

POST
/collections/:collection_name/facet
POST
/collections/:collection_name/facet
$curl -X POST http://localhost:6333/collections/collection_name/facet \
> -H "api-key: <apiKey>" \
> -H "Content-Type: application/json" \
> -d '{
> "key": "string"
>}'
200Successful
1{
2 "usage": {
3 "hardware": {
4 "cpu": 1,
5 "payload_io_read": 1,
6 "payload_io_write": 1,
7 "payload_index_io_read": 1,
8 "payload_index_io_write": 1,
9 "vector_io_read": 1,
10 "vector_io_write": 1
11 },
12 "inference": {
13 "models": {}
14 }
15 },
16 "time": 0.002,
17 "status": "ok",
18 "result": {
19 "hits": [
20 {
21 "value": "string",
22 "count": 1
23 }
24 ]
25 }
26}
Retrieves facets for the specified payload field.
Was this page helpful?
Previous

Search points

Next
Built with

Authentication

api-keystring
API Key authentication via header

Path parameters

collection_namestringRequired
Name of the collection to facet in

Query parameters

consistencyinteger or enumOptional
Define read consistency guarantees for the operation
timeoutintegerOptional>=1
If set, overrides global timeout for this request. Unit is seconds.

Request

Request counts of points for each unique value of a payload key
keystringRequired
Payload key to use for faceting.
shard_keystring or uint64 or list of strings or uint64s or object or anyOptional
limitinteger or nullOptional>=1
Max number of hits to return. Default is 10.
filterobject or anyOptional

Filter conditions - only consider points that satisfy these conditions.

exactboolean or nullOptional
Whether to do a more expensive exact count for each of the values in the facet. Default is false.

Response

successful operation
usageobject or any
timedouble
Time spent to process this request
statusstring
resultobject