Web3.bio Profile API

API Endpoints

The main public API endpoint domain for Web3.bio Profile API is api.web3.bio, and the staging domain is api-staging.web3.bio.

Web3.bio Profile API also provides basic profiles for name service resolution under api.web3.bio/ns (Replace profile with ns).

Authentication

The Profile API is free, but usage without API keys includes rate limiting mechanisms to ensure fair usage and prevent abuse. If you need an API Key, you can obtain one by contacting Web3.bio via Twitter (X) or Telegram group.

Please include the API key in the request header using the following format:X-API-KEY: Bearer {API_KEY}.

Examples

// Shell
curl -H "X-API-KEY: Bearer YOUR_API_KEY" https://api.web3.bio/profile/vitalik.eth

// Javascript
fetch("https://api.web3.bio/profile/vitalik.eth", {
  headers: {
    "X-API-KEY": "Bearer YOUR_API_KEY"
  }
})
                

Universal Profiles

Fetch detailed Universal Profiles across multiple platforms.

Endpoints

Parameters

• identity string
  An Ethereum address, an ENS domain, a Basenames domain, a Linea Name Service domain, a Farcaster username (ends with .farcaster), a Lens handle or an Unstoppable Domains domain.

Examples

• Ethereum /profile/0xd8da...6045OR/ns/0xd8da...6045
• ENS /profile/vitalik.ethOR/ns/vitalik.eth
• Basenames /profile/tony.base.ethOR/ns/tony.base.eth
• Linea /profile/name.linea.ethOR/ns/name.linea.eth
• Farcaster /profile/dwr.eth.farcasterOR/ns/dwr.eth.farcaster
• Lens /profile/stani.lensOR/ns/stani.lens
• Unstoppable Domains /profile/sandy.nftOR/ns/sandy.nft

Responses

// https://api.web3.bio/profile/0xd8da6bf26964af9d7eed9e03e53415d37aa96045
// https://api.web3.bio/profile/vitalik.eth
[
    {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "identity": "vitalik.eth",
        "platform": "ens",
        "displayName": "vitalik.eth",
        "avatar": "https://euc.li/vitalik.eth",
        "description": "mi pinxe lo crino tcati",
        "status": null,
        "email": null,
        "location": null,
        "header": "https://pbs.twimg.com/profile_banners/295218901/1638557376/1500x500",
        "contenthash": "ipfs://bafybeie734kfgfk66fm2uiygvretlr6nzyf2fdlstzezrqxciwden6zai4",
        "links": {
            "website": {
                "link": "https://vitalik.ca",
                "handle": "vitalik.ca",
                "sources": []
            },
            "github": {
                "link": "https://github.com/vbuterin",
                "handle": "vbuterin",
                "sources": []
            },
            "twitter": {
                "link": "https://x.com/VitalikButerin",
                "handle": "VitalikButerin",
                "sources": []
            }
        },
        "social": {
            "uid": null,
            "follower": 4449,
            "following": 10
        }
    },
    {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "identity": "vitalik.eth",
        "platform": "farcaster",
        "displayName": "Vitalik Buterin",
        "avatar": "https://i.imgur.com/IzJxuId.jpg",
        "description": "hullo",
        "status": null,
        "email": null,
        "location": null,
        "header": null,
        "contenthash": null,
        "links": {
            "farcaster": {
                "link": "https://warpcast.com/vitalik.eth",
                "handle": "vitalik.eth",
                "sources": [
                    "farcaster"
                ]
            }
        },
        "social": {
            "uid": 5650,
            "follower": 396461,
            "following": 73
        }
    },
    {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "identity": "vitalik.lens",
        "platform": "lens",
        "displayName": "vitalik.lens",
        "avatar": "https://api.hey.xyz/avatar?id=100275",
        "description": null,
        "status": null,
        "email": null,
        "location": null,
        "header": null,
        "contenthash": null,
        "links": {
            "lens": {
                "link": "https://www.lensfrens.xyz/vitalik",
                "handle": "vitalik",
                "sources": [
                    "lens"
                ]
            }
        },
        "social": {
            "uid": null,
            "follower": 42267,
            "following": 7
        }
    }
]

// https://api.web3.bio/ns/0xd8da6bf26964af9d7eed9e03e53415d37aa96045
// https://api.web3.bio/ns/vitalik.eth
[
    {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "identity": "vitalik.eth",
        "platform": "ens",
        "displayName": "vitalik.eth",
        "avatar": "https://euc.li/vitalik.eth",
        "description": "mi pinxe lo crino tcati"
    },
    {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "identity": "vitalik.eth",
        "platform": "farcaster",
        "displayName": "Vitalik Buterin",
        "avatar": "https://i.imgur.com/IzJxuId.jpg",
        "description": "hullo"
    },
    {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "identity": "vitalik.lens",
        "platform": "lens",
        "displayName": "vitalik.lens",
        "avatar": "https://api.hey.xyz/avatar?id=100275",
        "description": null
    }
]

Farcaster Profile API

Fetch a detailed Farcaster profile using an Ethereum address or Farcaster username/fname or encoded Farcaster FID.

Endpoints

Parameters

• identity string
  An Ethereum address or Farcaster username/fname or encoded Farcaster FID.

Examples

• Ethereum /profile/farcaster/0x8fc5...a2eaOR/ns/farcaster/0x8fc5...a2ea
• Farcaster /profile/farcaster/dwr.ethOR/ns/farcaster/dwr.eth
• Farcaster /profile/farcaster/farcaster,#3OR/ns/farcaster/farcaster,#3

// https://api.web3.bio/profile/farcaster/0x8fc5d6afe572fefc4ec153587b63ce543f6fa2ea
// https://api.web3.bio/profile/farcaster/dwr.eth
// https://api.web3.bio/profile/farcaster/farcaster%2C%233
{
    "address": "0xd7029bdea1c17493893aafe29aad69ef892b8ff2",
    "identity": "dwr.eth",
    "platform": "farcaster",
    "displayName": "Dan Romero",
    "avatar": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original",
    "description": "Working on Farcaster and Warpcast.",
    "status": null,
    "email": null,
    "location": null,
    "header": null,
    "contenthash": null,
    "links": {
        "farcaster": {
            "link": "https://warpcast.com/dwr.eth",
            "handle": "dwr.eth",
            "sources": [
                "farcaster"
            ]
        }
    },
    "social": {
        "uid": 3,
        "follower": 493153,
        "following": 3534
    }
}

// https://api.web3.bio/ns/farcaster/0x8fc5d6afe572fefc4ec153587b63ce543f6fa2ea
// https://api.web3.bio/ns/farcaster/dwr.eth
// https://api.web3.bio/ns/farcaster/farcaster%2C%233
{
    "address": "0x8fc5d6afe572fefc4ec153587b63ce543f6fa2ea",
    "identity": "dwr.eth",
    "platform": "farcaster",
    "displayName": "Dan Romero",
    "avatar": "https://res.cloudinary.com/merkle-manufactory/image/fetch/c_fill,f_png,w_256/https://lh3.googleusercontent.com/MyUBL0xHzMeBu7DXQAqv0bM9y6s4i4qjnhcXz5fxZKS3gwWgtamxxmxzCJX7m2cuYeGalyseCA2Y6OBKDMR06TWg2uwknnhdkDA1AA",
    "description": "Working on Farcaster and Warpcast."
}

Lens Profile API

Fetch a detailed Lens profile using an Ethereum address or Lens handle.

Endpoints

Parameters

• identity string
  An Ethereum address or a Lens handle

Examples

• Ethereum / Polygon /profile/lens/0x7241...9dffOR/ns/lens/0x7241...9dff
• Lens /profile/lens/stani.lensOR/ns/lens/stani.lens

// https://api.web3.bio/profile/lens/0x7241dddec3a6af367882eaf9651b87e1c7549dff
// https://api.web3.bio/profile/lens/stani.lens
{
    "address": "0x7241dddec3a6af367882eaf9651b87e1c7549dff",
    "identity": "stani.lens",
    "platform": "lens",
    "displayName": "Stani",
    "avatar": "https://ik.imagekit.io/lens/media-snapshot/98e279526cad20389c0959c26059cc3fe7a35793e8e050b43802916ea0d42d33.png",
    "email": null,
    "description": "@Avara (@Aave @Lens @Family)",
    "status": null,
    "email": null,
    "location": null,
    "header": "https://ik.imagekit.io/lens/media-snapshot/b23bb0344546aa064c6aeb39520e148576574113755385e5083465f25d2db098.webp",
    "contenthash": null,
    "links": {
        "lens": {
            "link": "https://www.lensfrens.xyz/stani",
            "handle": "stani",
            "sources": [
                "lens"
            ]
        }
    },
    "social": {
        "uid": null,
        "follower": 115084,
        "following": 1265
    }
}

// https://api.web3.bio/ns/lens/0x7241dddec3a6af367882eaf9651b87e1c7549dff
// https://api.web3.bio/ns/lens/stani.lens
{
    "address": "0x7241dddec3a6af367882eaf9651b87e1c7549dff",
    "identity": "stani.lens",
    "platform": "lens",
    "displayName": "Stani",
    "avatar": "https://ik.imagekit.io/lens/media-snapshot/e3adfb7046a549480a92c63de2d431f1ced8e516ea285970267c4dc24f941856.png",
    "description": "@Avara (@Aave @Lens @Family)"
}

Unstoppable Domains Profile API

Fetch a detailed Unstoppable Domains profile using an Ethereum address or Unstoppable Domains domain.

Endpoints

Parameters

• identity string
  An Ethereum address or an Unstoppable Domains domain.

Examples

• Ethereum /profile/unstoppabledomains/0x94ef...ab23OR/ns/unstoppabledomains/0x94ef...ab23
• Unstoppable Domains /profile/unstoppabledomains/sandy.nftOR/ns/unstoppabledomains/sandy.nft

// https://api.web3.bio/profile/unstoppabledomains/0x94ef5300cbc0aa600a821ccbc561b057e456ab23
// https://api.web3.bio/profile/unstoppabledomains/sandy.nft
{
    "address": "0x94ef5300cbc0aa600a821ccbc561b057e456ab23",
    "identity": "sandy.nft",
    "platform": "unstoppabledomains",
    "displayName": "Pink Mamba",
    "avatar": "https://storage.googleapis.com/unstoppable-client-assets/images/user/1092584/f259e49c-a3d3-429f-a703-2e9d35d8da21.png",
    "description": "COO of Unstoppable and Founder of Unstoppable Women of Web3 Sandy Carter is a leading voice in technology, social media, and web3/metaverse being recognized as TOP10 most powerful women in tech.",
    "status": null,
    "email": null,
    "location": "Metaverse",
    "header": "https://storage.googleapis.com/unstoppable-client-assets/images/user/1092584/4d3f4608-6b29-4847-95d3-e7484b255278.png",
    "contenthash": "ipfs://Qmar8DH5xBihbGU449zKAg4sx7ahHbFZgksYHKBFFhfVq7",
    "links": {
        "twitter": {
            "link": "https://x.com/Sandy_carter",
            "handle": "Sandy_carter",
            "sources": []
        },
        "telegram": {
            "link": "https://t.me/sandycarter",
            "handle": "sandycarter",
            "sources": []
        },
        "youtube": {
            "link": "https://www.youtube.com/@sandycarter3993",
            "handle": "@sandycarter3993",
            "sources": []
        }
    },
    "social": {
        "uid": "sandy.nft",
        "follower": 137,
        "following": 0
    }
}

// https://api.web3.bio/ns/unstoppabledomains/0x94ef5300cbc0aa600a821ccbc561b057e456ab23
// https://api.web3.bio/ns/unstoppabledomains/sandy.nft
{
    "address": "0x94ef5300cbc0aa600a821ccbc561b057e456ab23",
    "identity": "sandy.nft",
    "platform": "unstoppabledomains",
    "displayName": "Pink Mamba",
    "avatar": "https://storage.googleapis.com/unstoppable-client-assets/images/user/1092584/f259e49c-a3d3-429f-a703-2e9d35d8da21.png",
    "description": "COO of Unstoppable and Founder of Unstoppable Women of Web3 Sandy Carter is a leading voice in technology, social media, and web3/metaverse being recognized as TOP10 most powerful women in tech."
}

Solana / SNS Profile API

Fetch a detailed Solana Name Service (SNS) profile using a Solana address or Solana Name Service domain

Endpoints

Parameters

• identity string
  A Solana address or a Solana Name Service domain.

Examples

• Solana /profile/solana/HKKp49qGWXd6...OR/ns/solana/HKKp49qGWXd6...
• Solana Name Service /profile/solana/bonfida.solOR/ns/solana/bonfida.sol

// https://api.web3.bio/profile/solana/HKKp49qGWXd639QsuH7JiLijfVW5UtCVY4s1n2HANwEA
// https://api.web3.bio/profile/solana/bonfida.sol
{
    "address": "HKKp49qGWXd639QsuH7JiLijfVW5UtCVY4s1n2HANwEA",
    "identity": "bonfida.sol",
    "platform": "sns",
    "displayName": "bonfida.sol",
    "avatar": null,
    "description": null,
    "status": null,
    "email": null,
    "location": null,
    "header": null,
    "contenthash": null,
    "links": {},
    "social": {}
}

// https://api.web3.bio/ns/solana/HKKp49qGWXd639QsuH7JiLijfVW5UtCVY4s1n2HANwEA
// https://api.web3.bio/ns/solana/bonfida.sol
{
    "address": "HKKp49qGWXd639QsuH7JiLijfVW5UtCVY4s1n2HANwEA",
    "identity": "bonfida.sol",
    "platform": "sns",
    "displayName": "bonfida.sol",
    "avatar": null,
    "description": null,
}

.bit Profile API

Fetch a detailed .bit profile using an Ethereum address or .bit domain.

Endpoints

Parameters

• identity string
  An Ethereum address or a .bit domain.

Examples

• Ethereum /profile/dotbit/0xfa8f...7f1dOR/ns/dotbit/0xfa8f...7f1d
• .bit /profile/dotbit/bestcase.bitOR/ns/dotbit/bestcase.bit

// https://api.web3.bio/profile/dotbit/0xfa8fa9cf58eaff86aa208366a14d69de87867f1d
// https://api.web3.bio/profile/dotbit/bestcase.bit
{
    "address": "0xfa8fa9cf58eaff86aa208366a14d69de87867f1d",
    "identity": "bestcase.bit",
    "platform": "dotbit",
    "displayName": "bestcase.bit",
    "avatar": "https://uploads-ssl.webflow.com/621ed3ca24af847de76a2dae/635cf43497c26382c70e1c15_bestcase.jpg",
    "description": ".bit is a brand dedicated to assist every single individual and community to unleash their potential and discover more possibilities through the development of self-sovereign identity.   .bit (https://did.id) is also a product which is the only cross-chain unified DID protocol, based on the unique technical architecture, .bit provides services for more than Web3 users. .bit is able to verify signatures by different asymmetric cryptographic algorithms, which allow users to manage and control their .bit accounts with public chain addresses, email addresses, even customized passcodes and biometric data from mobile devices.  .bit determines to build the most practical and applicable suite of infrastructural tools, safeguarding the endowed right of identity sovereignty for each bit of the world.",
    "status": null,
    "email": null,
    "location": null,
    "header": null,
    "contenthash": "ipns://libp2p.io",
    "links": {
        "twitter": {
            "link": "https://x.com/dotbitHQ",
            "handle": "dotbitHQ",
            "sources": []
        },
        "github": {
            "link": "https://github.com/dotbitHQ",
            "handle": "dotbitHQ",
            "sources": []
        },
        "discord": {
            "link": "https://discord.com/invite/did",
            "handle": "did",
            "sources": []
        },
        "website": {
            "link": "https://www.did.id/",
            "handle": "www.did.id",
            "sources": []
        },
        "nostr": {
            "link": "https://app.coracle.social/npub1y0epuwrv23vcue2g5ft8armwdsjfd4dy6frzwmw72y847d3v2ahq7vh2ag",
            "handle": "npub1y0epuwrv23vcue2g5ft8armwdsjfd4dy6frzwmw72y847d3v2ahq7vh2ag",
            "sources": []
        },
        "opensea": {
            "link": "https://opensea.io/collection/dotbit",
            "handle": "dotbit",
            "sources": []
        }
    },
    "social": {}
}

// https://api.web3.bio/ns/dotbit/0xfa8fa9cf58eaff86aa208366a14d69de87867f1d
// https://api.web3.bio/ns/dotbit/bestcase.bit
{
    "address": "0xfa8fa9cf58eaff86aa208366a14d69de87867f1d",
    "identity": "bestcase.bit",
    "platform": "dotbit",
    "displayName": "bestcase.bit",
    "avatar": "https://uploads-ssl.webflow.com/621ed3ca24af847de76a2dae/635cf43497c26382c70e1c15_bestcase.jpg",
    "description": ".bit is a brand dedicated to assist every single individual and community to unleash their potential and discover more possibilities through the development of self-sovereign identity.   .bit (https://did.id) is also a product which is the only cross-chain unified DID protocol, based on the unique technical architecture, .bit provides services for more than Web3 users. .bit is able to verify signatures by different asymmetric cryptographic algorithms, which allow users to manage and control their .bit accounts with public chain addresses, email addresses, even customized passcodes and biometric data from mobile devices.  .bit determines to build the most practical and applicable suite of infrastructural tools, safeguarding the endowed right of identity sovereignty for each bit of the world."
}

Batch Profile Query

Fetch profiles for multiple identities using a list of query IDs.

Endpoints

Parameters

• ids string[]
  An array of strings where each string is formatted as platform,identity, encoded using encodeURIComponent. The array is limited to a maximum of 30 items per query.
  Supported platforms include Ethereum, ENS, Basenames, Linea Name Service, Farcaster and Lens.

[
    "ens,vitalik.eth",
    "lens,stani.lens",
    "farcaster,dwr.eth",
    "basenames,tony.base.eth",
    "ethereum,0x934b510d4c9103e6a87aef13b816fb080286d649",
    "linea,name.linea.eth",
]

Examples

• Ethereum ethereum,0xd8da...6045ORens,0x934b...d649
• ENS ens,vitalik.eth
• Farcaster farcaster,dwr.ethORfarcaster,0xd702...8ff2ORfarcaster,#3
• Lens lens,stani.lensORlens,0xd8da...6045
• Basenames basenames,tony.base.eth
• Linea Name Service linea,name.linea.eth

Responses

// https://api.web3.bio/profile/batch/%5B%22ens%2Cvitalik.eth%22%2C%22lens%2Cstani.lens%22%2C%22farcaster%2Cdwr.eth%22%2C%22basenames%2Ctony.base.eth%22%2C%22ethereum%2C0x934b510d4c9103e6a87aef13b816fb080286d649%22%5D
[
    {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "identity": "vitalik.eth",
        "platform": "ens",
        "displayName": "vitalik.eth",
        "avatar": "https://euc.li/vitalik.eth",
        "description": "mi pinxe lo crino tcati",
        "status": null,
        "email": null,
        "location": null,
        "header": "https://pbs.twimg.com/profile_banners/295218901/1638557376/1500x500",
        "contenthash": "ipfs://bafybeie734kfgfk66fm2uiygvretlr6nzyf2fdlstzezrqxciwden6zai4",
        "links": {
            "website": {
                "link": "https://vitalik.ca",
                "handle": "vitalik.ca",
                "sources": []
            },
            "github": {
                "link": "https://github.com/vbuterin",
                "handle": "vbuterin",
                "sources": []
            },
            "twitter": {
                "link": "https://x.com/VitalikButerin",
                "handle": "VitalikButerin",
                "sources": []
            }
        },
        "social": {},
        "aliases": [
            "ens,vitalik.eth",
            "ens,0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
        ]
    },
    {
        "address": "0x7241dddec3a6af367882eaf9651b87e1c7549dff",
        "identity": "stani.lens",
        "platform": "lens",
        "displayName": "Stani",
        "avatar": "https://ik.imagekit.io/lens/media-snapshot/98e279526cad20389c0959c26059cc3fe7a35793e8e050b43802916ea0d42d33.png",
        "description": "@Avara (@Aave @Lens @Family)",
        "status": null,
        "email": null,
        "location": null,
        "header": "https://ik.imagekit.io/lens/media-snapshot/b23bb0344546aa064c6aeb39520e148576574113755385e5083465f25d2db098.webp",
        "contenthash": null,
        "links": {
            "lens": {
                "link": "https://www.lensfrens.xyz/stani",
                "handle": "stani",
                "sources": []
            }
        },
        "social": {
            "uid": null,
            "following": 1265,
            "follower": 115084
        },
        "aliases": [
            "lens,stani.lens",
            "lens,0x7241dddec3a6af367882eaf9651b87e1c7549dff"
        ]
    },
    {
        "address": "0xd7029bdea1c17493893aafe29aad69ef892b8ff2",
        "identity": "dwr.eth",
        "platform": "farcaster",
        "displayName": "Dan Romero",
        "avatar": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original",
        "description": "Working on Farcaster and Warpcast.",
        "status": null,
        "email": null,
        "location": null,
        "header": null,
        "contenthash": null,
        "links": {
            "farcaster": {
                "link": "https://warpcast.com/dwr.eth",
                "handle": "dwr.eth",
                "sources": []
            }
        },
        "social": {
            "uid": 3,
            "following": 3534,
            "follower": 493153
        },
        "aliases": [
            "farcaster,#3",
            "farcaster,dwr",
            "farcaster,dwr.eth",
            "farcaster,danromero.eth",
            "farcaster,0xd7029bdea1c17493893aafe29aad69ef892b8ff2"
        ]
    },
    {
        "address": "0x041be0b39a80388364fe223dcd2b733d5a1144c4",
        "identity": "tony.base.eth",
        "platform": "basenames",
        "displayName": "tony.base.eth",
        "avatar": "https://zku9gdedgba48lmr.public.blob.vercel-storage.com/basenames/avatar/tony.base.eth/1724097976538/to-KihxRGRzOZbjF9tW937zYGMLMYQOjz.png",
        "description": "mfer building on base",
        "status": null,
        "email": null,
        "location": null,
        "header": null,
        "contenthash": null,
        "links": {
            "website": {
                "link": "https://mint.club",
                "handle": "mint.club",
                "sources": []
            },
            "github": {
                "link": "https://github.com/tonymfer",
                "handle": "tonymfer",
                "sources": []
            },
            "twitter": {
                "link": "https://x.com/tonmfer",
                "handle": "tonmfer",
                "sources": []
            },
            "farcaster": {
                "link": "https://warpcast.com/to",
                "handle": "to",
                "sources": []
            }
        },
        "social": {},
        "aliases": [
            "basenames,tony.base.eth",
            "basenames,0x041be0b39a80388364fe223dcd2b733d5a1144c4"
        ]
    },
    {
        "address": "0x934b510d4c9103e6a87aef13b816fb080286d649",
        "identity": "sujiyan.eth",
        "platform": "ens",
        "displayName": "sujiyan.eth",
        "avatar": "https://i.imgur.com/rkMlngS_d.webp?maxwidth=640&shape=thumb&fidelity=medium",
        "description": null,
        "status": null,
        "email": "suji.yan@dimension.im",
        "location": null,
        "header": "https://rainbow.mypinata.cloud/ipfs/QmUpk4q82RFMTLU9nLtheenjMn56UMJsAMrHs55PK1iJtW",
        "contenthash": "ipns://k51qzi5uqu5di7afkyk8msyok5bxqlaudfzem68t8jilihitaz6ii523ve9tbw",
        "links": {
            "website": {
                "link": "https://mask.io",
                "handle": "mask.io",
                "sources": []
            },
            "github": {
                "link": "https://github.com/tedko",
                "handle": "tedko",
                "sources": []
            },
            "twitter": {
                "link": "https://x.com/suji_yan",
                "handle": "suji_yan",
                "sources": []
            },
            "instagram": {
                "link": "https://www.instagram.com/suji_yan_",
                "handle": "suji_yan_",
                "sources": []
            }
        },
        "social": {},
        "aliases": [
            "ethereum,0x934b510d4c9103e6a87aef13b816fb080286d649"
        ]
    }
]

// https://api.web3.bio/ns/batch/%5B%22ens%2Cvitalik.eth%22%2C%22lens%2Cstani.lens%22%2C%22farcaster%2Cdwr.eth%22%2C%22basenames%2Ctony.base.eth%22%2C%22ethereum%2C0x934b510d4c9103e6a87aef13b816fb080286d649%22%5D
[
    {
        "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "identity": "vitalik.eth",
        "platform": "ens",
        "displayName": "vitalik.eth",
        "avatar": "https://euc.li/vitalik.eth",
        "description": "mi pinxe lo crino tcati",
        "aliases": [
            "ens,vitalik.eth",
            "ens,0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
        ]
    },
    {
        "address": "0x7241dddec3a6af367882eaf9651b87e1c7549dff",
        "identity": "stani.lens",
        "platform": "lens",
        "displayName": "Stani",
        "avatar": "https://ik.imagekit.io/lens/media-snapshot/98e279526cad20389c0959c26059cc3fe7a35793e8e050b43802916ea0d42d33.png",
        "description": "@Avara (@Aave @Lens @Family)",
        "aliases": [
            "lens,stani.lens",
            "lens,0x7241dddec3a6af367882eaf9651b87e1c7549dff"
        ]
    },
    {
        "address": "0xd7029bdea1c17493893aafe29aad69ef892b8ff2",
        "identity": "dwr.eth",
        "platform": "farcaster",
        "displayName": "Dan Romero",
        "avatar": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/bc698287-5adc-4cc5-a503-de16963ed900/original",
        "description": "Working on Farcaster and Warpcast.",
        "aliases": [
            "farcaster,#3",
            "farcaster,dwr",
            "farcaster,dwr.eth",
            "farcaster,danromero.eth",
            "farcaster,0xd7029bdea1c17493893aafe29aad69ef892b8ff2"
        ]
    },
    {
        "address": "0x041be0b39a80388364fe223dcd2b733d5a1144c4",
        "identity": "tony.base.eth",
        "platform": "basenames",
        "displayName": "tony.base.eth",
        "avatar": "https://zku9gdedgba48lmr.public.blob.vercel-storage.com/basenames/avatar/tony.base.eth/1724097976538/to-KihxRGRzOZbjF9tW937zYGMLMYQOjz.png",
        "description": "mfer building on base",
        "aliases": [
            "basenames,tony.base.eth",
            "basenames,0x041be0b39a80388364fe223dcd2b733d5a1144c4"
        ]
    },
    {
        "address": "0x934b510d4c9103e6a87aef13b816fb080286d649",
        "identity": "sujiyan.eth",
        "platform": "ens",
        "displayName": "sujiyan.eth",
        "avatar": "https://i.imgur.com/rkMlngS_d.webp?maxwidth=640&shape=thumb&fidelity=medium",
        "description": null,
        "aliases": [
            "ethereum,0x934b510d4c9103e6a87aef13b816fb080286d649"
        ]
    }
]

Status and Errors

Successful responses are indicated with a 200 HTTP status code.

Error responses are served with a non-200-series HTTP code, specifically 404 or 500. Typical error responses contain an error node indicating a human-readable description of the error.

// https://api.web3.bio/profile/web3bio_example.eth
{
    "address": null,
    "identity": "web3bio_example.eth",
    "platform": "ens",
    "error": "Not Found"
}

Release Notes

We are gradually making updates to Web3.bio Profile API. You may expect new features, improvements and bug fixes. If you have any feedback on the features or want to report a bug, please reach out to us on Web3.bio Twitter or Telegram group.

🎨 March Update

• Feature Added new field status to the Profile API.

🏝️ February Update

• Feature Added Linea Name Service query support to the Profile API.

🎊 November Update

• Feature Added Batch Query support to the Profile API.

🏝️ October Update

• Feature Added Basenames query support to the Profile API.

🏝️ March Update

• Feature Added Solana Name Service (Bonfida) query support to the Profile API.

🛠️ January Update

• Update Added contenthash field for more complete ENS, Unstoppable Domains and .bit Profile API queries.
• Update Added offchain query support for ENS Profile API.

🎊 December Update

• Feature Added ns basic profile resolution query support to the Profile API.

🎊 November Update

• Feature Added Unstoppable Domains query support to the Profile API.
• Update Added Ethereum address query support to all Profile APIs.

🛠️ October Update

• Change Deprecated addresses field for faster ENS API queries.

🔮 August Update

• Feature Added .bit query support to the Profile API.
• Update Added ENS username support in the Farcaster Profile API.

🎁 June Update

• Feature Added Universal Profile API. Developers can Fetch universal profiles across supported platforms with a single query.

🎉 May Update

• Feature Added Ethereum Name Service (ENS), Lens, and Farcaster support to the Profile API.