---
title: "Service: /groups/{group}/search/facets [GET]"
source: https://dev.pageseeder.com/api/services/group-search-facets-GET.html
description: "Returns search facets for a single group, filtering results by question, fields, and facet parameters. Restricted to guests and higher unless the group is publicly accessible."
last_updated: 2026-09-02T11:36:00+10:00
document_type: api_endpoint
operation_id: search-GET
resource_id: search
path_template: /groups/{group}/search/facets
http_method: GET
api_category: search
implementation_version: null
api_since: 5.9400
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: null
generated_at: 2026-09-02
tokens: ~402
---

# /groups/\{group\}/search/facets \[GET\]

## Description

Get search facets for a single group.

This service does the same as the group search but only the facets for the search are returned.

For details see [Service: /groups/\{group\}/search \[GET\]](group-search-GET.md).

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| facets | A comma-separated list of fields to use as facets | no | strings |  |
| facetsize | The max number of facet values to load (ignored if larger than global property `maxFacetSize` - default `100`) | no | integer | `10` |
| filters | A comma-separated list of field:term pairs to use as filters | no | strings |  |
| flexiblefacets | A comma-separated list of fields to use as flexible facets | no | strings |  |
| question | The question to search for | no | string |  |
| questionfields | A comma-separated list of fields to search the question in | no | strings | `pstitle,pscontent` |
| ranges | A comma-separated list of range searches | no | strings |  |

## Permission

This service is restricted to guest and higher unless the group is accessible to public.

## Response

The XML response is:

```xml

<facets indexes="[comma separated group IDs]" [warning=""]>
  ...
</facets>
```

For details see [Service: /groups/\{group\}/search \[GET\]](group-search-GET.md).

## Error Handling

| 0x1501 | If there is an invalid group specified |
| --- | --- |
| 0x1505 | If the facet size specified is bigger than the global property for face size ( maxFacetSize) |
| 0x1506 | If a numeric field is specified as a facet |