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

filter

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
}