Facets


GET /search/facets
will return result of faceting your library by some predetermined set of asset fields.

All existing library values for the fields are retrieved together with the number of assets for each field value.

Available Facets Result Set

Currently we are only retrieving the result of faceting by file extension field. The facets call will retrieve all existing file extension values (together with the number of assets of each file extension) grouped by asset file type.

In the future we are planning to include results of faceting by fields like dimension, orientation, color mode, aspect ratio, resolution, frame rate and bit rate.

Response (example)

{
  "payload": [
    {
      "facetName": "imageFileExtension",
      "facets": {
          "JPEG": 85,
          "ARW": 1,
          "PNG": 1
      }
    },
    {
      "facetName": "videoFileExtension",
      "facets": {
          "MP4": 10,
          "WMV": 8,
          "AVI": 1,
          "VOB": 1
      }
    },
    {
      "facetName": "audioFileExtension",
      "facets": {
          "M4A": 1,
          "MP3": 1
      }
    },
    {
      "facetName": "adobeFileExtension",
      "facets": {
          "AI": 2
      }
    },
    {       "facetName": "wordFileExtension",
      "facets": {
          "DOC": 2,
          "DOCX": 1
      }
    },
    {
      "facetName": "excelFileExtension",
      "facets": {
          "XLSX": 1
      }
    },
    {
      "facetName": "powerpointFileExtension",
      "facets": {}
      },
    {
      "facetName": "pdfFileExtension",
      "facets": {
          "PDF": 1
      }
    },
    {
      "facetName": "otherFileExtension",
      "facets": {
          "XML": 2
      }
    }
   ]
}