Skip To Content

Blockdaemon Documentation

GET NFT Collections Search by Name

GET NFT Collections Search by Name
Ubiquity NFT URL
Path Parameters
Query Parameters
Example Queries
Example Response

GET NFT Collections Search by Name

https://{ubiquity_nft_url}/{protocol}/{network}/collections/search

Returns NFT collections with names matching a given search string (see required parameters). The response includes top 50 most relevant results, sorted in descending order.

Developer documentation: GET NFT Collections Search by Name
Learn how to authorize your request: Authentication Guide

Notes:

  • Blockdaemon collects NFT information and data from various third-party sources (“NFT Content”). We do not create, own, or control NFT Content and we do not routinely monitor NFT Content for violations of these Terms. You acknowledge that Blockdaemon has no responsibility or liability related to NFT Content and agree that you must evaluate, and decide for yourself if you wish to use any NFT Content.
  • To get more information about a particular collection, use GET NFT Collection.

Ubiquity URL

To run a query, add your Ubiquity NFT URL. For most users this will be:

  • svc.blockdaemon.com/nft/v1

An example of this is shown below:

https://svc.blockdaemon.com/nft/v1/{protocol}/{network}/collections/search

Note: If you created your Ubiquity API Key before September 2022, add the legacy Ubiquity NFT URL:

  • ubiquity.api.blockdaemon.com/nft/v1

An example of this is shown below:

https://ubiquity.api.blockdaemon.com/nft/v1/{protocol}/{network}/collections/search

Path Parameters

You should specify a protocol and a network as path parameters, e.g.:

  • ethereum/mainnet

Query Parameters

Required Parameters

To search by collection name, use:

  • parameter: name
  • value: e.g. bored ape

Notes:

  • Search is case insensitive.
  • A search string must be between 1 and 50 characters.
  • Unicode characters are supported.

Additional Parameters

To get only verified collections, use the following parameter:

  • parameter: verified
  • value: true
    (see the verified section of the response)

To set the maximum number of collections returned on one page, use

  • parameter: page_size
  • value: 50 by default, up to 100

Example Queries

The queries in this section provide useful examples for GET NFT Collections Search by Name.

For more details, visit: How to Find a Collection by Name and Get Its Assets

Search Collections by Name

To search Ethereum Mainnet collections by name (bored ape), use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collections/search?name=bored ape

The query will return collections with matching names:

  • Basic Bored Ape Club
  • Bored Ape Comic
  • Bored Ape Yacht Club
  • Bored Ape Mountain Club
  • Bored Awesome Apes
  • Bored Crypto Apes
  • Bored Eminape Yacht Club
  • The Bored Ape Punk Club
  • BoredApeDinoClub
  • etc.

Search Verified Collections by Name

To search verified Ethereum Mainnet collections by name (bored ape), use the following query:

https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collections/search?name=bored ape&verified=true

Example Response

The following is a typical response from GET NFT Collections Search by Name:

{
    "data": [
        {
            "id": "4203aedd-7964-5fe1-b932-eb8c4fda7822",
            "name": "Bored Ape Yacht Club",
            "logo": "collection/4203aedd-7964-5fe1-b932-eb8c4fda7822/logo.png",
            "contracts": [
                "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"
            ],
            "verified": true
        }
        {...more collections...}
    ]
}

Notes:

  • One collection can include multiple contracts, so the contracts field returns an array.
  • The logo field returns media paths for the top popular collections. Use the following endpoint to retrieve media: GET NFT Media

We don't support Internet Explorer

Please use Chrome, Safari, Firefox, or Edge to view this site.