API Endpoints
OpenSea

Get filter facets for a collection group

get
https://api.opensea.io/api/v2/nfts/group//facets

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Collection group

Query Params
facet_types
array of strings

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

facet_types
collection_slugs
array of strings

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

collection_slugs
franchise
array of strings

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.

franchise
grader
array of strings

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.

grader
grade
array of strings

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.

grade
subject
array of strings

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.

subject
year
array of strings

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.

year
set
array of strings

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.

set
language
array of strings

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.

language
edition
array of strings

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.

edition
product_type
array of strings

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.

product_type
Responses

500

Internal server error. Please open a support ticket so OpenSea can investigate.

Updated about 10 hours ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*

Updated about 10 hours ago