/opensea/items/search

curl --request POST \
  --url https://api.anysite.io/api/opensea/items/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "collection_slug": "<string>",
  "count": 2,
  "timeout": 300,
  "status": "all",
  "sort": "price_low_to_high",
  "attributes": {
    "Background": [
      "Army Green"
    ]
  }
}
'

[
  {
    "contract_address": "<string>",
    "token_id": "<string>",
    "@type": "OpenseaItem",
    "chain": "<string>",
    "name": "<string>",
    "image": "<string>",
    "animation_url": "<string>",
    "description": "<string>",
    "standard": "<string>",
    "is_fungible": false,
    "total_supply": 123,
    "rarity_rank": 123,
    "rarity_category": "<string>",
    "image_aspect_ratio": 123,
    "background_color": "<string>",
    "token_uri": "<string>",
    "metadata_storage": "<string>",
    "owner": "<string>",
    "last_sale": {
      "@type": "OpenseaPrice",
      "usd": 123,
      "amount": 123,
      "symbol": "<string>",
      "native": 123
    },
    "best_listing": {
      "@type": "OpenseaListing",
      "price": {
        "@type": "OpenseaPrice",
        "usd": 123,
        "amount": 123,
        "symbol": "<string>",
        "native": 123
      },
      "marketplace": "<string>",
      "maker": "<string>",
      "quantity_remaining": 123,
      "start_time": "<string>",
      "end_time": "<string>"
    },
    "best_offer": {
      "@type": "OpenseaPrice",
      "usd": 123,
      "amount": 123,
      "symbol": "<string>",
      "native": 123
    },
    "collection": {
      "slug": "<string>",
      "@type": "OpenseaItemCollection",
      "name": "<string>",
      "image": "<string>",
      "category": "<string>",
      "external_url": "<string>",
      "standard": "<string>",
      "is_verified": false,
      "floor_price": {
        "@type": "OpenseaPrice",
        "usd": 123,
        "amount": 123,
        "symbol": "<string>",
        "native": 123
      }
    },
    "attributes": [],
    "created_at": "<string>",
    "last_sale_at": "<string>",
    "last_transfer_at": "<string>"
  }
]

/opensea

/opensea/items/search

Search and list the NFTs in an OpenSea collection, with status, trait and sort filters

Price: 1 credit

💡 AI Hint: Search and list the NFTs inside an OpenSea collection by its slug (e.g. ‘boredapeyachtclub’). Filter by listing status (all, listed or not listed) and by traits (a mapping of trait type to accepted values), and sort by price (low to high / high to low) or rarity (most / least rare). Each item returns its chain, contract address and token id, name and image, rarity rank, last sale, best listing and best offer (in native, token and USD), owner, parent collection and traits.

⚠️ Common errors: 412: Collection not found

POST

api

opensea

items

/opensea/items/search

curl --request POST \
  --url https://api.anysite.io/api/opensea/items/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "collection_slug": "<string>",
  "count": 2,
  "timeout": 300,
  "status": "all",
  "sort": "price_low_to_high",
  "attributes": {
    "Background": [
      "Army Green"
    ]
  }
}
'

[
  {
    "contract_address": "<string>",
    "token_id": "<string>",
    "@type": "OpenseaItem",
    "chain": "<string>",
    "name": "<string>",
    "image": "<string>",
    "animation_url": "<string>",
    "description": "<string>",
    "standard": "<string>",
    "is_fungible": false,
    "total_supply": 123,
    "rarity_rank": 123,
    "rarity_category": "<string>",
    "image_aspect_ratio": 123,
    "background_color": "<string>",
    "token_uri": "<string>",
    "metadata_storage": "<string>",
    "owner": "<string>",
    "last_sale": {
      "@type": "OpenseaPrice",
      "usd": 123,
      "amount": 123,
      "symbol": "<string>",
      "native": 123
    },
    "best_listing": {
      "@type": "OpenseaListing",
      "price": {
        "@type": "OpenseaPrice",
        "usd": 123,
        "amount": 123,
        "symbol": "<string>",
        "native": 123
      },
      "marketplace": "<string>",
      "maker": "<string>",
      "quantity_remaining": 123,
      "start_time": "<string>",
      "end_time": "<string>"
    },
    "best_offer": {
      "@type": "OpenseaPrice",
      "usd": 123,
      "amount": 123,
      "symbol": "<string>",
      "native": 123
    },
    "collection": {
      "slug": "<string>",
      "@type": "OpenseaItemCollection",
      "name": "<string>",
      "image": "<string>",
      "category": "<string>",
      "external_url": "<string>",
      "standard": "<string>",
      "is_verified": false,
      "floor_price": {
        "@type": "OpenseaPrice",
        "usd": 123,
        "amount": 123,
        "symbol": "<string>",
        "native": 123
      }
    },
    "attributes": [],
    "created_at": "<string>",
    "last_sale_at": "<string>",
    "last_transfer_at": "<string>"
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

collection_slug

string

required

Collection slug to search within (its human-readable alias from the collection URL)

Minimum string length: 1

Examples:

"boredapeyachtclub"

"pudgypenguins"

count

integer

required

Number of items to return

Required range: x >= 1

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

status

enum<string>

default:all

Listing status filter

Available options:

all,

listed,

not_listed

sort

enum<string>

default:price_low_to_high

Sort order

Available options:

price_low_to_high,

price_high_to_low,

most_rare,

least_rare

attributes

object

Trait filter mapping a trait type to the accepted values (e.g. {"Background": ["Army Green", "Blue"]})

Show child attributes

Example:

{ "Background": ["Army Green"] }

Response

Successful Response

contract_address

string

required

token_id

string

required

@type

string

default:OpenseaItem

chain

string | null

name

string | null

image

string | null

animation_url

string | null

description

string | null

standard

string | null

is_fungible

boolean

default:false

total_supply

integer | null

rarity_rank

integer | null

rarity_category

string | null

image_aspect_ratio

number | null

background_color

string | null

token_uri

string | null

metadata_storage

string | null

owner

string | null

last_sale

object

Show child attributes

best_listing

object

Show child attributes

best_offer

object

Show child attributes

collection

object

Show child attributes

attributes

object[]

Show child attributes

created_at

string | null

last_sale_at

string | null

last_transfer_at

string | null

/opensea/items/activity /opensea/tokens