Links

SocialFollowings API

Learn all the detailed references of SocialFollowings API that provide a given user's social followings information, including the input filters, supported chains, and output fields.
The SocialFollowings APIs deliver on-chain and off-chain user-level data pertaining to users of web3 social protocols, such as Farcaster and Lens.

Inputs

Filters

Name
Type
Description
blockNumber
Int_Comparator_Exp
Blocknumber when the follows occured onchain.
dappName
SocialDappName_Comparator_Exp
Social DApp name – lens, farcaster
dappSlug
SocialDappSlug_Comparator_Exp
Social DApp slug (contract version) – lens_polygon, lens_v2_polygon, farcaster_optimism, farcaster_goerli
followerProfileId
String_Comparator_Exp
The Lens Profile NFT Token ID of the user's follower. Farcaster is empty
followingProfileId
String_Comparator_Exp
The Lens Profile NFT Token ID of the user's following. Farcaster is empty
followingSince
Time_Comparator_Exp
Time the follows was started
identity
Identity_Comparator_Exp
Identity: blockchain address, domain name, social identity

Blockchain

For SocialFollowings API, it will return Lens & Farcaster followers data from all onchain and offchain sources.
You just need to specify the input to ALL for the query to work.
Enum
Description
ALL
-

Outputs

type SocialFollowing {
blockchain: Blockchain # Blockchain associated with the social identity
dappName: # Social DApp name
dappSlug: # Social DApp slug (contract version)
followerAddress: # Nested query - list of all followers
followerProfileId:
followerTokenId:
followingAddress: # Nested query - list of all followings
followingProfileId:
id: ID # Airstack unique identifier for this particular element
}