How to Get a Collection by Name

This tutorial explains the steps involved in getting any Ethereum Mainnet collection by its name.

Step 1. Use the collections endpoint with the following details:

• protocol: ethereum

• network: mainnet

  https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collections
  

Step 2. Add the following parameter:

• collection name

  • parameter: collection_name
  • value: e.g. Bored Ape Yacht Club

  https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collections?collection_name=Bored Ape Yacht Club
  

Step 3. Execute the query.

For example, in cURL, you should run the following code:

curl -X GET 'https://svc.blockdaemon.com/nft/v1/ethereum/mainnet/collections?collection_name=Bored%20Ape%20Yacht%20Club' -H 'Authorization: Bearer YOUR_API_KEY'

📘

Note!

• To authorize your request, you need to get an API key and use it as a bearer token or a query parameter. Learn more: Authentication Guide
• Sometimes collection names contain whitespaces. When using cURL, replace them with %20.

Step 4. Your results will look something like this:

{
    "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...}
    ],
    "meta": {
        "paging": {
            "next_page_token": ""
        }
    }
}