OPopensea
NFT Endpoints

Get filter facets for a collection group

Changed on

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.

get/api/v2/nfts/group/{group}/facets

Request

Path parameters

groupstring required

Collection group

Query parameters

facet_typesstring[]

Facet types to return. Defaults to all: franchise, grader, grade, subject, year, set, language, edition, product_type

collection_slugsstring[]

Restrict results to these collections in the group (max 10). Defaults to the whole group.

franchisestring[]

Only return NFTs whose normalized franchise is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

graderstring[]

Only return NFTs whose normalized grader is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

gradestring[]

Only return NFTs whose normalized grade is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

subjectstring[]

Only return NFTs whose normalized subject is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

yearstring[]

Only return NFTs whose normalized year is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

setstring[]

Only return NFTs whose normalized set is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

languagestring[]

Only return NFTs whose normalized language is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

editionstring[]

Only return NFTs whose normalized edition is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

product_typestring[]

Only return NFTs whose normalized product type is one of these values, as returned by the facets endpoint. Repeat the parameter to match any of several values.

Response

OK

Example response

{
  "facets": [
    {
      "type": "grader"
    }
  ]
}

Changes