---
title: "Search NFTs across a collection group"
method: GET
path: "/api/v2/nfts/group/{group}"
tags: ["NFT Endpoints"]
---

# Search NFTs across a collection group

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

## Request

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

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.

## Path parameters

- `group` string, required

## Query parameters

- `collection_slugs` string[]
- `query` string
- `is_listed` boolean
- `min_estimated_value_usd` number, double
- `max_estimated_value_usd` number, double
- `sort_by` string
- `sort_direction` string
- `limit` integer: Number of items to return per page
- `next` string
- `franchise` string[]
- `grader` string[]
- `grade` string[]
- `subject` string[]
- `year` string[]
- `set` string[]
- `language` string[]
- `edition` string[]
- `product_type` string[]

## Response `200`

OK

- StandardizedNftListResponse
  - `next` string, nullable: Cursor for the next page of results
  - `nfts` StandardizedNft[], required
    - `best_listing_price` ListingPriceResponse: Price of a listing in its payment token, with its USD equivalent
      - `amount` string, required: Amount in the payment token's units
      - `currency` string, nullable: Payment token symbol
      - `usd` string, nullable: USD equivalent. Null when no USD price is available for the token.
    - `collection` string, required
    - `contract` string, required
    - `decimals` integer, nullable
    - `description` string, nullable
    - `display_animation_url` string, nullable
    - `display_image_url` string, nullable
    - `estimated_value_usd` string, nullable: Estimated value in USD
    - `identifier` string, required
    - `image_url` string, nullable
    - `is_disabled` boolean, required
    - `is_nsfw` boolean, required
    - `metadata_url` string, nullable
    - `name` string, nullable
    - `opensea_url` string, required
    - `original_animation_url` string, nullable
    - `original_image_url` string, nullable
    - `token_standard` string, required
    - `traits` Trait[], required
      - `display_type` string, nullable
      - `max_value` string, nullable
      - `trait_type` string, required
      - `value` unknown, required
    - `updated_at` 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/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)