Facets / filters / aggregations is one of the powerful feature of ItemsAPI and work almost completely out of the box. It is a way to filter items to get more narrow and precise results.

There are few type of aggregations. The first one is the simplest terms. The field for terms be string (i.e. some country) or array (i.e. list of tags)

    "schema": {
        "country": {
            "type": "string",
            "index": "not_analyzed",
            "store": true
    "aggregations": {
        "country": {
            "type": "terms",
            "field": "country",
            "size": 10,
            "conjunction": true,
            "title": "Country"

It looks like:

Aggregation example
Was this page helpful ?