SocialFollowers API

Learn all the detailed references of SocialFollowers API that provide a given user's social followers information, including the input filters, supported chains, and output fields.

The SocialFollowers 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
followerSince	Time_Comparator_Exp	Time the follows was started
identity	Identity_Comparator_Exp	Identity: blockchain address, domain name, social identity

blockchain

For SocialFollowers 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

Name	Type	Description
blockchain	EveryBlockchain	Blockchain associated with the social identity.
blockNumber	Int	Blocknumber when the follows occured onchain.
dappName	String	Social DApp name – lens, farcaster
dappSlug	String	Social DApp slug (contract version) – lens_polygon, lens_v2_polygon, farcaster_optimism, farcaster_goerli
followerAddress	Wallet	Nested Query – Follower identity details, e.g. 0x address, Farcaster, ENS, etc.
followerProfileId	String	Follower FID for Farcaster or follower's token ID for Lens.
followerSince	Time	Timestamp when follows occured onchain.
followingAddress	Wallet	Nested Query – Following identity details, e.g. 0x address, Farcaster, ENS, etc.
followingProfileId	String	Following FID for Farcaster or following's token ID for Lens.
id	ID	Airstack Internal ID.