---
title: "Get filter facets for a collection group"
method: GET
path: "/api/v2/nfts/group/{group}/facets"
tags: ["NFT Endpoints"]
---

# Get filter facets for a collection group

`GET /api/v2/nfts/group/{group}/facets`

## Request

- Base URL: `https://api.opensea.io`
- URL: `https://api.opensea.io/api/v2/nfts/group/{group}/facets`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/nfts/group/:group/facets/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the values of each normalized attribute in a collection group with the number of matching NFTs. Each facet is narrowed by the filters of the other types, so a facet keeps listing all of its own values.

## Path parameters

- `group` string, required

## Query parameters

- `facet_types` string[]
- `collection_slugs` string[]
- `franchise` string[]
- `grader` string[]
- `grade` string[]
- `subject` string[]
- `year` string[]
- `set` string[]
- `language` string[]
- `edition` string[]
- `product_type` string[]

## Response `200`

OK

- StandardizedNftFacetsResponse
  - `facets` FacetGroupResponse[], required
    - `type` string, required: Facet type, also the query parameter that filters on it
    - `values` FacetValueResponse[], required
      - `count` integer, required
      - `value` string, required

## Other responses

- `400`: For error reasons, review the response data.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Resource not found
- `409`: Conflict
- `500`: Internal server error. Please open a support ticket so OpenSea can investigate.

## Changes

- **2026-11-03** `2c7935d84f90`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/opensea/apis/opensea-api/changes/api/v2/nfts/group/:group/facets/get.md)

---

[API](https://skmtc.dev/opensea/apis/opensea-api.md) - [All operations](https://skmtc.dev/opensea/apis/opensea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opensea/apis/opensea-api/revisions/2c7935d84f90?raw)