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}.

Universal Profile API

Retrieve Universal profiles or name service resolution across 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",
        "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",
        "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,
        "email": null,
        "location": null,
        "header": null,
        "contenthash": null,
        "links": {
            "lens": {
                "link": "https://www.lensfrens.xyz/vitalik",
                "handle": "vitalik",
                "sources": [
                    "lens"
                ]
            }
        },
        "social": {
            "uid": 100275,
            "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

Retrieve a Farcaster profile or name service resolution

Endpoints

Parameters

• identity string
  An Ethereum address or a Farcaster username/fname or a Farcaster FID (with fid/).

Examples

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

// https://api.web3.bio/profile/farcaster/0x8fc5d6afe572fefc4ec153587b63ce543f6fa2ea
// https://api.web3.bio/profile/farcaster/dwr.eth
// https://api.web3.bio/profile/farcaster/fid/3
{
    "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.",
    "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/fid/3
{
    "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

Retrieve a Lens profile or name service resolution

Endpoints

Parameters

• identity string
  An Ethereum/Polygon 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)",
    "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": 5,
        "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

Retrieve an Unstoppable Domains profile or name service resolution

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.",
    "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

Retrieve a Solana / Solana Name Service (SNS) profile or name service resolution

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,
    "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

Retrieve a .bit profile or name service resolution

Endpoints

Parameters

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

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.",
    "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 Query

Retrieve profiles for multiple identities using 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.

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

Examples

• Ethereum ethereum,0xd8da...6045ORens,0x934b...d649
• ENS ens,vitalik.eth
• Farcaster farcaster,dwr.ethORfarcaster,0xd702...8ff2ORfarcaster,#3
• Lens lens,stani.lensORlens,0xd8da...6045ORlens,#11874
• Basenames basenames,tony.base.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",
        "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)",
        "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": 5,
            "following": 1265,
            "follower": 115084
        },
        "aliases": [
            "lens,#5",
            "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.",
        "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",
        "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,
        "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,#5",
            "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.

🏝️ 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 retrieve 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.