Links

Lens Profile Details

Learn how to fetch Lens profile details with 0x address, ENS domain, Lens profile name and ID, and Farcaster name and ID.

✍ Lens Profile Details

Airstack provides easy-to-use APIs for enriching Lens applications and integrating on-chain and off-chain data with Lens.

Table Of Contents

In this guide you will learn how to use Airstack to:

Pre-requisites

  • An Airstack account (free)
  • Basic knowledge of GraphQL

Get Started

JavaScript/TypeScript/Python
If you are using JavaScript/TypeScript or Python, Install the Airstack SDK:
npm
yarn
pnpm
pip
React
npm install @airstack/airstack-react
Node
npm install @airstack/node
React
yarn add @airstack/airstack-react
Node
yarn add @airstack/node
React
pnpm install @airstack/airstack-react
Node
pnpm install @airstack/node
pip install airstack
Then, add the following snippets to your code:
React
Node
Python
import { init, useQuery } from "@airstack/airstack-react";
init("YOUR_AIRSTACK_API_KEY");
const query = `YOUR_QUERY`; // Replace with GraphQL Query
const Component = () => {
const { data, loading, error } = useQuery(query);
if (data) {
return <p>Data: {JSON.stringify(data)}</p>;
}
if (loading) {
return <p>Loading...</p>;
}
if (error) {
return <p>Error: {error.message}</p>;
}
};
import { init, fetchQuery } from "@airstack/node";
init("YOUR_AIRSTACK_API_KEY");
const query = `YOUR_QUERY`; // Replace with GraphQL Query
const { data, error } = await fetchQuery(query);
console.log("data:", data);
console.log("error:", error);
import asyncio
from airstack.execute_query import AirstackClient
api_client = AirstackClient(api_key="YOUR_AIRSTACK_API_KEY")
query = """YOUR_QUERY""" # Replace with GraphQL Query
async def main():
execute_query_client = api_client.create_execute_query_object(
query=query)
query_response = await execute_query_client.execute_query()
print(query_response.data)
asyncio.run(main())
Other Programming Languages
To access the Airstack APIs in other languages, you can use https://api.airstack.xyz/gql as your GraphQL endpoint.

🤖 AI Natural Language

Airstack provides an AI solution for you to build GraphQL queries to fulfill your use case easily. You can find the AI prompt of each query in the demo's caption or title for yourself to try.
Airstack AI (Demo)

Get Lens Profile Details By Farcaster ID

You can get the Lens profile details by their Farcaster ID:

Try Demo

https://app.airstack.xyz/query/PXvk55hBBU
Show all lens profile details and registration info for farcaster user fc_fid:5650

Code

Query
Response
query MyQuery {
Socials(
input: {
filter: { dappName: { _eq: lens }, identity: { _eq: "fc_fid:3" } }
blockchain: ethereum
}
) {
Social {
id
chainId
blockchain
dappName
dappSlug
dappVersion
userId
userAddress
userCreatedAtBlockTimestamp
userCreatedAtBlockNumber
userLastUpdatedAtBlockTimestamp
userLastUpdatedAtBlockNumber
userHomeURL
userRecoveryAddress
userAssociatedAddresses
profileName
profileTokenId
profileTokenAddress
profileCreatedAtBlockTimestamp
profileCreatedAtBlockNumber
profileLastUpdatedAtBlockTimestamp
profileLastUpdatedAtBlockNumber
profileTokenUri
isDefault
identity
handleTokenAddress
handleTokenId
metadataURI
profileMetadata
coverImageURI
twitterUserName
website
location
profileHandle
profileHandleNft {
address
}
coverImageContentValue {
image {
small
}
}
profileImageContentValue {
image {
small
}
}
}
}
}
{
"data": {
"Socials": {
"Social": [
{
"id": "57e3c7ae14d823399f2e2c6c57c6c926766b4ca37ff60908822d91297eb13986",
"chainId": "137",
"blockchain": "polygon",
"dappName": "lens",
"dappSlug": "lens_polygon",
"dappVersion": "polygon",
"userId": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userCreatedAtBlockNumber": 35512897,
"userLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userLastUpdatedAtBlockNumber": 35512897,
"userHomeURL": "",
"userRecoveryAddress": "",
"userAssociatedAddresses": [
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
],
"profileName": "lens/@vitalik",
"profileTokenId": "100275",
"profileTokenAddress": "0xdb46d1dc155634fbc732f92e853b10b288ad5a1d",
"profileCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"profileCreatedAtBlockNumber": 35512897,
"profileLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"profileLastUpdatedAtBlockNumber": 35512897,
"profileTokenUri": "",
"isDefault": false,
"identity": "fc_fid:5650",
"handleTokenAddress": "0xe7e7ead361f3aacd73a61a9bd6c10ca17f38e945",
"handleTokenId": "79233663829379634837589865448569342784712482819484549289560981379859480642508",
"metadataURI": "ipfs://QmXbed4geE1dq7KXfQimFz26frmY6XxvudU2QFaPx4a9FX",
"profileMetadata": {
"appId": "LensClaimingApp",
"attributes": [
{
"displayType": "string",
"key": "app",
"value": "LensClaimingApp"
}
],
"bio": "Ethereum\n\nFable of the Dragon Tyrant (not mine but it's important): https://www.youtube.com/watch?v=cZYNADOHhVY\n\nAbolish daylight savings time and leap seconds",
"cover_picture": null,
"location": null,
"metadata_id": "f98a49e2-3dae-40f6-9a74-9466efb4a56c",
"name": "Vitalik Buterin",
"social": [
{
"displayType": "string",
"key": "website",
"value": null
},
{
"displayType": "string",
"key": "twitter",
"value": null
}
],
"version": "1.0.0"
},
"coverImageURI": "",
"twitterUserName": "",
"website": "",
"location": "",
"profileHandle": "@vitalik",
"profileHandleNft": {
"address": "0xe7e7ead361f3aacd73a61a9bd6c10ca17f38e945"
},
"coverImageContentValue": {
"image": null
},
"profileImageContentValue": {
"image": null
}
}
]
}
}
}

Get Lens Profile Details By Farcaster Name

You can get the Lens profile details by their Farcaster Name:

Try Demo

https://app.airstack.xyz/query/wJvbCHRULZ
Show all lens profile details and registration info for farcaster user fc_fname:vitalik.eth

Code

Query
Response
query MyQuery {
Socials(
input: {
filter: {
dappName: { _eq: lens }
identity: { _eq: "fc_fname:vitalik.eth" }
}
blockchain: ethereum
}
) {
Social {
id
chainId
blockchain
dappName
dappSlug
dappVersion
userId
userAddress
userCreatedAtBlockTimestamp
userCreatedAtBlockNumber
userLastUpdatedAtBlockTimestamp
userLastUpdatedAtBlockNumber
userHomeURL
userRecoveryAddress
userAssociatedAddresses
profileName
profileTokenId
profileTokenAddress
profileCreatedAtBlockTimestamp
profileCreatedAtBlockNumber
profileLastUpdatedAtBlockTimestamp
profileLastUpdatedAtBlockNumber
profileTokenUri
isDefault
identity
handleTokenAddress
handleTokenId
metadataURI
profileMetadata
coverImageURI
twitterUserName
website
location
profileHandle
profileHandleNft {
address
}
coverImageContentValue {
image {
small
}
}
profileImageContentValue {
image {
small
}
}
}
}
}
{
"data": {
"Socials": {
"Social": [
{
"id": "57e3c7ae14d823399f2e2c6c57c6c926766b4ca37ff60908822d91297eb13986",
"chainId": "137",
"blockchain": "polygon",
"dappName": "lens",
"dappSlug": "lens_polygon",
"dappVersion": "polygon",
"userId": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userCreatedAtBlockNumber": 35512897,
"userLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userLastUpdatedAtBlockNumber": 35512897,
"userHomeURL": "",
"userRecoveryAddress": "",
"userAssociatedAddresses": [
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
],
"profileName": "lens/@vitalik",
"profileTokenId": "100275",
"profileTokenAddress": "0xdb46d1dc155634fbc732f92e853b10b288ad5a1d",
"profileCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"profileCreatedAtBlockNumber": 35512897,
"profileLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"profileLastUpdatedAtBlockNumber": 35512897,
"profileTokenUri": "",
"isDefault": false,
"identity": "fc_fname:vitalik.eth",
"handleTokenAddress": "0xe7e7ead361f3aacd73a61a9bd6c10ca17f38e945",
"handleTokenId": "79233663829379634837589865448569342784712482819484549289560981379859480642508",
"metadataURI": "ipfs://QmXbed4geE1dq7KXfQimFz26frmY6XxvudU2QFaPx4a9FX",
"profileMetadata": {
"appId": "LensClaimingApp",
"attributes": [
{
"displayType": "string",
"key": "app",
"value": "LensClaimingApp"
}
],
"bio": "Ethereum\n\nFable of the Dragon Tyrant (not mine but it's important): https://www.youtube.com/watch?v=cZYNADOHhVY\n\nAbolish daylight savings time and leap seconds",
"cover_picture": null,
"location": null,
"metadata_id": "f98a49e2-3dae-40f6-9a74-9466efb4a56c",
"name": "Vitalik Buterin",
"social": [
{
"displayType": "string",
"key": "website",
"value": null
},
{
"displayType": "string",
"key": "twitter",
"value": null
}
],
"version": "1.0.0"
},
"coverImageURI": "",
"twitterUserName": "",
"website": "",
"location": "",
"profileHandle": "@vitalik",
"profileHandleNft": {
"address": "0xe7e7ead361f3aacd73a61a9bd6c10ca17f38e945"
},
"coverImageContentValue": {
"image": null
},
"profileImageContentValue": {
"image": null
}
}
]
}
}
}

Get Lens Profile Details By 0x address

You can get the Lens profile details by their 0x address:

Try Demo

https://app.airstack.xyz/query/LfkdEgsNU3
Show all lens profile details and registration info for 0xd8da6bf26964af9d7eed9e03e53415d37aa96045

Code

Query
Response
query MyQuery {
Socials(
input: {
filter: {
dappName: { _eq: lens }
identity: { _eq: "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }
}
blockchain: ethereum
}
) {
Social {
id
chainId
blockchain
dappName
dappSlug
dappVersion
userId
userAddress
userCreatedAtBlockTimestamp
userCreatedAtBlockNumber
userLastUpdatedAtBlockTimestamp
userLastUpdatedAtBlockNumber
userHomeURL
userRecoveryAddress
userAssociatedAddresses
profileName
profileTokenId
profileTokenAddress
profileCreatedAtBlockTimestamp
profileCreatedAtBlockNumber
profileLastUpdatedAtBlockTimestamp
profileLastUpdatedAtBlockNumber
profileTokenUri
isDefault
identity
handleTokenAddress
handleTokenId
metadataURI
profileMetadata
coverImageURI
twitterUserName
website
location
profileHandle
profileHandleNft {
address
}
coverImageContentValue {
image {
small
}
}
profileImageContentValue {
image {
small
}
}
}
}
}
{
"data": {
"Socials": {
"Social": [
{
"id": "57e3c7ae14d823399f2e2c6c57c6c926766b4ca37ff60908822d91297eb13986",
"chainId": "137",
"blockchain": "polygon",
"dappName": "lens",
"dappSlug": "lens_polygon",
"dappVersion": "polygon",
"userId": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userCreatedAtBlockNumber": 35512897,
"userLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userLastUpdatedAtBlockNumber": 35512897,
"userHomeURL": "",
"userRecoveryAddress": "",
"userAssociatedAddresses": [
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
],
"profileName": "lens/@vitalik",
"profileTokenId": "100275",
"profileTokenAddress": "0xdb46d1dc155634fbc732f92e853b10b288ad5a1d",
"profileCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"profileCreatedAtBlockNumber": 35512897,
"profileLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"profileLastUpdatedAtBlockNumber": 35512897,
"profileTokenUri": "",
"isDefault": false,
"identity": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"handleTokenAddress": "0xe7e7ead361f3aacd73a61a9bd6c10ca17f38e945",
"handleTokenId": "79233663829379634837589865448569342784712482819484549289560981379859480642508",
"metadataURI": "ipfs://QmXbed4geE1dq7KXfQimFz26frmY6XxvudU2QFaPx4a9FX",
"profileMetadata": {
"appId": "LensClaimingApp",
"attributes": [
{
"displayType": "string",
"key": "app",
"value": "LensClaimingApp"
}
],
"bio": "Ethereum\n\nFable of the Dragon Tyrant (not mine but it's important): https://www.youtube.com/watch?v=cZYNADOHhVY\n\nAbolish daylight savings time and leap seconds",
"cover_picture": null,
"location": null,
"metadata_id": "f98a49e2-3dae-40f6-9a74-9466efb4a56c",
"name": "Vitalik Buterin",
"social": [
{
"displayType": "string",
"key": "website",
"value": null
},
{
"displayType": "string",
"key": "twitter",
"value": null
}
],
"version": "1.0.0"
},
"coverImageURI": "",
"twitterUserName": "",
"website": "",
"location": "",
"profileHandle": "@vitalik",
"profileHandleNft": {
"address": "0xe7e7ead361f3aacd73a61a9bd6c10ca17f38e945"
},
"coverImageContentValue": {
"image": null
},
"profileImageContentValue": {
"image": null
}
}
]
}
}
}

Get Lens Profile Details By ENS Domain

You can get the Farcaster user profile details by their ENS domain:

Try Demo

https://app.airstack.xyz/query/v4NtCmLXSB
Show all lens profile details and registration info for vitalik.eth

Code

Query
Response
query MyQuery {
Socials(
input: {
filter: { dappName: { _eq: lens }, identity: { _eq: "vitalik.eth" } }
blockchain: ethereum
}
) {
Social {
id
chainId
blockchain
dappName
dappSlug
dappVersion
userId
userAddress
userCreatedAtBlockTimestamp
userCreatedAtBlockNumber
userLastUpdatedAtBlockTimestamp
userLastUpdatedAtBlockNumber
userHomeURL
userRecoveryAddress
userAssociatedAddresses
profileName
profileTokenId
profileTokenAddress
profileCreatedAtBlockTimestamp
profileCreatedAtBlockNumber
profileLastUpdatedAtBlockTimestamp
profileLastUpdatedAtBlockNumber
profileTokenUri
isDefault
identity
handleTokenAddress
handleTokenId
metadataURI
profileMetadata
coverImageURI
twitterUserName
website
location
profileHandle
profileHandleNft {
address
}
coverImageContentValue {
image {
small
}
}
profileImageContentValue {
image {
small
}
}
}
}
}
{
"data": {
"Socials": {
"Social": [
{
"id": "57e3c7ae14d823399f2e2c6c57c6c926766b4ca37ff60908822d91297eb13986",
"chainId": "137",
"blockchain": "polygon",
"dappName": "lens",
"dappSlug": "lens_polygon",
"dappVersion": "polygon",
"userId": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userCreatedAtBlockNumber": 35512897,
"userLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userLastUpdatedAtBlockNumber": 35512897,
"userHomeURL": "",
"userRecoveryAddress": "",
"userAssociatedAddresses": [
"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
],
"profileName": "lens/@vitalik",
"profileTokenId": "100275",
"profileTokenAddress": "0xdb46d1dc155634fbc732f92e853b10b288ad5a1d",
"profileCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"profileCreatedAtBlockNumber": 35512897,
"profileLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"profileLastUpdatedAtBlockNumber": 35512897,
"profileTokenUri": "",
"isDefault": false,
"identity": "vitalik.eth",
"handleTokenAddress": "0xe7e7ead361f3aacd73a61a9bd6c10ca17f38e945",
"handleTokenId": "79233663829379634837589865448569342784712482819484549289560981379859480642508",
"metadataURI": "ipfs://QmXbed4geE1dq7KXfQimFz26frmY6XxvudU2QFaPx4a9FX",
"profileMetadata": {
"appId": "LensClaimingApp",
"attributes": [
{
"displayType": "string",
"key": "app",
"value": "LensClaimingApp"
}
],
"bio": "Ethereum\n\nFable of the Dragon Tyrant (not mine but it's important): https://www.youtube.com/watch?v=cZYNADOHhVY\n\nAbolish daylight savings time and leap seconds",
"cover_picture": null,
"location": null,
"metadata_id": "f98a49e2-3dae-40f6-9a74-9466efb4a56c",
"name": "Vitalik Buterin",
"social": [
{
"displayType": "string",
"key": "website",
"value": null
},
{
"displayType": "string",
"key": "twitter",
"value": null
}
],
"version": "1.0.0"
},
"coverImageURI": "",
"twitterUserName": "",
"website": "",
"location": "",
"profileHandle": "@vitalik",
"profileHandleNft": {
"address": "0xe7e7ead361f3aacd73a61a9bd6c10ca17f38e945"
},
"coverImageContentValue": {
"image": null
},
"profileImageContentValue": {
"image": null
}
}
]
}
}
}

Get Lens Profile Details By Lens Profile Name

You can get the Lens profile details by their Lens profile name:

Try Demo

https://app.airstack.xyz/query/JjYZwRJ2Sg
Show all lens profile details and registration info for lens/@vitalik

Code

Query
Response
query MyQuery {
Socials(
input: {
filter: { dappName: { _eq: lens }, identity: { _eq: "lens/@vitalik" } }
blockchain: ethereum
}
) {
Social {
id
chainId
blockchain
dappName
dappSlug
dappVersion
userId
userAddress
userCreatedAtBlockTimestamp
userCreatedAtBlockNumber
userLastUpdatedAtBlockTimestamp
userLastUpdatedAtBlockNumber
userHomeURL
userRecoveryAddress
userAssociatedAddresses
profileName
profileTokenId
profileTokenAddress
profileCreatedAtBlockTimestamp
profileCreatedAtBlockNumber
profileLastUpdatedAtBlockTimestamp
profileLastUpdatedAtBlockNumber
profileTokenUri
isDefault
identity
handleTokenAddress
handleTokenId
metadataURI
profileMetadata
coverImageURI
twitterUserName
website
location
profileHandle
profileHandleNft {
address
}
coverImageContentValue {
image {
small
}
}
profileImageContentValue {
image {
small
}
}
}
}
}
{
"data": {
"Socials": {
"Social": [
{
"id": "57e3c7ae14d823399f2e2c6c57c6c926766b4ca37ff60908822d91297eb13986",
"chainId": "137",
"blockchain": "polygon",
"dappName": "lens",
"dappSlug": "lens_polygon",
"dappVersion": "polygon",
"userId": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"userCreatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userCreatedAtBlockNumber": 35512897,
"userLastUpdatedAtBlockTimestamp": "2022-11-12T11:05:35Z",
"userLastUpdatedAtBlockNumber": 35512897,
"userHomeURL": "",