Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Rarible Search API API

The Search API API from Rarible — 7 operation(s) for search api.

Rarible Search API API is one of 18 APIs that Rarible publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Search API. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 7 operations across 7 paths, and defines 126 schemas. It is described by OpenAPI 3.0.3, at version v0.1.

Requests are made against a single base URL, https://{environment}.rarible.org.

7 operations 7 paths 126 schemas 1 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
v0.1
Base URL
https://api.rarible.org/v0.1
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Rarible Search API API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-KEY (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 1 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Search API 7
GET
/v0.1/items/traits/search
Search NFT collection traits
searchTraits 3 params → 200400500
POST
/v0.1/items/search
Search NFTs
searchItems body → 200400500
POST
/v0.1/items/search/duplicates
Search Duplicated NFTs
searchDuplicatedItems body → 200400500
POST
/v0.1/ownerships/search
Search NFT Ownerships
searchOwnerships body → 200400500
POST
/v0.1/activities/search
Search Activities
searchActivities body → 200400500
POST
/v0.1/activities/search/count
Count activities that match the search request
searchActivitiesCount body → 200400500
POST
/v0.1/collections/search
Search NFT Collections
searchCollection body → 200400500

Schemas 126

The contract defines 126 schemas that model the data the API accepts and returns. The most detailed are Item (28 properties), Order (25 properties), ItemsSearchFilter (24 properties), Collection (23 properties). Each schema is shown below with its type and property counts.

ActivityType
string
EthErc1155LazyAssetType
object
9 properties 8 required
CollectionsSearchFilter
object
Filter for collections search query
2 properties 1 required
ItemRoyalty
object
2 properties 2 required
Trait
object
Combination of Item attribute key with list of values
2 properties 2 required
DuplicatedItemGroups
object
2 properties 1 required
OrderMatchSwap
object
3 properties 2 required
ItemTraitProperty
object
Item trait property
3 properties 1 required
EthOrderBasicSeaportDataV1
object
1 property 1 required
TraitSort
object
Used when the search sort is set as TRAIT
3 properties 1 required
UnionApiErrorServerError
object
2 properties 2 required
ItemCollection
object
4 properties 2 required
CurrencyId
string
Currency Id, has format ETHEREUM:${token} or ETHEREUM:${token}:${tokenId}
SearchResultCount
object
1 property 1 required
Traits
object
2 properties 1 required
SolanaSolAssetType
object
1 property 1 required
AssetType
object
Meta
object
14 properties 3 required
Payout
object
2 properties 2 required
BigDecimal
string
OrderData
object
EthErc20AssetType
object
2 properties 2 required
MetaAttribute
object
4 properties 1 required
OrderListActivity
object
9 properties 6 required
MintActivity
object
12 properties 4 required
L2DepositActivity
object
6 properties 4 required
Items
object
3 properties 1 required
Ownerships
object
3 properties 1 required
EthOrderDataRaribleV2DataV3
object
4 properties 4 required
NftAssetType
object
4 properties 3 required
Activity
object
6 properties 2 required
TraitRange
object
Trait value range
2 properties 2 required
SolanaNftAssetType
object
4 properties 2 required
OrderMatchActivity
object
5 properties 2 required
L2WithdrawalActivity
object
6 properties 4 required
TokenCurrencyAssetType
object
2 properties 2 required
EthEthereumAssetType
object
2 properties 1 required
Asset
object
2 properties 2 required
ImageContent
object
3 properties
DuplicatedItemsSearchRequest
object
Search request for items with duplicated traits
4 properties 3 required
EthOrderDataRaribleV2DataV1
object
3 properties 3 required
EthSeaportConsideration
object
6 properties 6 required
ReceiveFromChainActivity
object
10 properties 7 required
ActivitySearchRequest
object
Complex search request for Activities
4 properties 2 required
AudioContent
object
1 property
Range
object
2 properties
ActivitySearchFilter
object
12 properties
Order
object
25 properties 14 required
ItemHistory
object
History of item
5 properties 3 required
OrderMatchSell
object
15 properties 6 required
EthCollectionAssetType
object
3 properties 2 required
Creator
object
2 properties 2 required
ActivitySearchSort
string
EthCryptoPunksAssetType
object
4 properties 3 required
EthRaribleV2OrderData
ActivityUserFilter
object
3 properties
OwnershipSearchFilter
object
Filter for ownerships search query
10 properties
ItemsSearchRequest
object
Complex search request for items
5 properties 2 required
OwnershipSearchSort
string
EthOrderDataRaribleV2DataV3Sell
object
6 properties 2 required
ItemTransfer
object
2 properties 4 required
VideoContent
object
3 properties
FeesValue
object
2 properties 1 required
ItemsSearchSort
string
TraitEntry
object
Combination of Item attribute key/value with it's count
2 properties 2 required
TransferActivity
object
11 properties 5 required
RawOrderData
object
2 properties 1 required
EthOrderDataRaribleV2DataV2
object
4 properties 4 required
SortOrder
string
OwnershipId
string
CollectionsSearchRequest
object
Complex search request for collections
3 properties 2 required
Rarity
object
2 properties
Collection
object
23 properties 5 required
Royalty
object
2 properties 2 required
ItemSearchFullText
object
2 properties 1 required
BurnActivity
object
9 properties 4 required
Item
object
28 properties 10 required
OrderId
string
CollectionId
string
Collection id
ItemId
string
Item Id, has format ETHEREUM:${token}:${tokenId}
ActivityBlockchainInfo
object
4 properties 4 required
MetaContent
object
6 properties 2 required
EthErc721AssetType
object
4 properties 3 required
EthOrderDataLegacy
object
2 properties 2 required
OwnershipSource
string
Collections
object
3 properties 1 required
SortType
string
OrderStatus
string
EthOrderDataRaribleV2DataV3Buy
object
5 properties 1 required
EthSeaportItemType
string
CollectionMeta
object
14 properties 2 required
ContractAddress
string
Blockchain contract address in Union format ETHEREUM:${token}
Platform
string
NativeCurrencyAssetType
object
3 properties 2 required
EthSeaportOffer
object
5 properties 5 required
ActivityCurrencyFilter
object
1 property
NftOfCollectionAssetType
object
2 properties 2 required
OwnershipSearchRequest
object
Ownerships complex search query
4 properties 2 required
OrderActivitySource
string
Model3dContent
object
1 property
OrderCancelBidActivity
object
9 properties 6 required
SendToChainActivity
object
10 properties 7 required
Activities
object
3 properties 1 required
BigInteger
string
OrderBidActivity
object
10 properties 6 required
EthOrderOpenSeaV1DataV1
object
16 properties 17 required
ActivityId
string
EthErc721LazyAssetType
object
8 properties 7 required
EthErc1155AssetType
object
4 properties 3 required
UnionApiErrorBadRequest
object
2 properties 2 required
RawJson
object
Blockchain
string
EthOrderCryptoPunksData
object
2 properties 1 required
EthOrderSeaportDataV1
object
9 properties 7 required
Ownership
object
16 properties 7 required
EthSeaportOrderType
string
DuplicatedItem
object
3 properties 3 required
OrderActivityMatchSide
object
3 properties 2 required
ItemsSearchFilter
object
Filter for items search query
24 properties
HtmlContent
object
1 property
OrderCancelListActivity
object
9 properties 6 required
EthGenerativeArtAssetType
object
3 properties 2 required
SolanaAuctionHouseDataV1
object
4 properties 1 required
UnionAddress
string
Blockchain address in Union format ${blockchainGroup}:${token}
SolanaFtAssetType
object
2 properties 2 required
ItemLastSale
object
6 properties 6 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

rarible-search-api-api-openapi.yml Raw ↑

Other APIs Rarible publishes across the network.

Rarible Charts API
Rarible Collection Leader Board API
Rarible Collection Statistics API
Rarible Currencies and rates API
Rarible Domain lookup API
Rarible Encode operations API
Rarible Indexer blocks API
Rarible NFT Activities API
Rarible NFT Collections API
Rarible NFT Data and Historical Statistics API
Rarible NFT Items API
Rarible NFT Ownerships API