API Endpoints
OpenSea

Search NFTs across a collection group

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

Search NFTs across every collection in a group, such as trading_cards, using normalized attributes that are consistent across issuers. Each attribute (franchise, grader, grade, subject, year, set, language, edition, product_type) is a repeatable query parameter, for example ?franchise=Pokemon&grader=PSA&grader=CGC&grade=10. Use /nfts/group/{group}/facets to discover values and counts.

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

Collection group

Query Params
collection_slugs
array of strings

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

collection_slugs
string

Full-text match on NFT name, up to 100 characters

boolean

Only return NFTs that are listed (true) or unlisted (false)

double

Minimum estimated value in USD, inclusive

double

Maximum estimated value in USD, inclusive

string
Defaults to best_deal

Sort field: price, top_offer, last_sale, last_sale_date, created_date, received_date, listing_created_date, best_deal, or estimated_value

string
Defaults to desc

Sort direction: asc or desc

int32
1 to 100
Defaults to 50

Number of items to return per page

string
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 8 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 8 hours ago