Social API

Social identity endpoints for Farcaster, Lens, and more.

Endpoints

Method	Path	Description
GET	/api/badges/{name}	Achievement badges and POAPs
GET	/api/followers/{name}	List of followers with ENS names
GET	/api/following/{name}	List of accounts being followed
GET	/api/guild/{id}	Guild.xyz membership
GET	/api/leaderboard	Top accounts by follower count
GET	/api/lens/{handle}	Lens Protocol profile
GET	/api/lens/address/{address}	Lens by ETH address
GET	/api/lens/explore	Explore Lens
GET	/api/lens/profile/{handle}	Lens profile
GET	/api/lens/profile/{handle}/followers	Lens followers
GET	/api/lens/profile/{handle}/following	Lens following
GET	/api/lens/profile/{handle}/posts	Lens posts
GET	/api/lens/search	Search Lens profiles
GET	/api/lens/stats	Lens protocol stats
GET	/api/mutuals/{name}	Mutual followers (follow each other)
GET	/api/passport/{address}	Gitcoin Passport humanity score
GET	/api/poaps/{address}	POAP badges collection
GET	/api/recommend/{name}	AI-powered account recommendations
GET	/api/reputation/{name}	Social reputation score
GET	/api/safe/{address}	Safe/multisig info
GET	/api/snapshot/proposals/{space}	DAO proposals
GET	/api/snapshot/space/{id}	Snapshot DAO space info
GET	/api/snapshot/votes/{address}	Address voting history
GET	/api/social/{name}	Follower and following counts
GET	/api/social/farcaster/{identifier}	Farcaster profile
GET	/api/social/farcaster/{identifier}/casts	User's casts
GET	/api/social/farcaster/{identifier}/followers	User's followers
GET	/api/social/farcaster/{identifier}/following	User's following
GET	/api/social/farcaster/address/{address}	Lookup by ETH address
GET	/api/social/farcaster/cast/{hash}	Cast details
GET	/api/social/farcaster/cast/{hash}/reactions	Cast reactions
GET	/api/social/farcaster/cast/{hash}/replies	Cast replies
GET	/api/social/farcaster/channel/{id}	Channel details
GET	/api/social/farcaster/channel/{name}/feed	Channel feed
GET	/api/social/farcaster/channels	All channels
GET	/api/social/farcaster/feed/{fid}	User feed
GET	/api/social/farcaster/notifications/{fid}	User notifications
GET	/api/social/farcaster/power-badge	Power badge holders
GET	/api/social/farcaster/recent	Recent popular casts
GET	/api/social/farcaster/search	Search casts
GET	/api/social/farcaster/search/users	Search users
GET	/api/social/farcaster/stats	Protocol stats
GET	/api/social/farcaster/trending/casts	Trending casts
GET	/api/social/farcaster/trending/users	Trending users
GET	/api/social/farcaster/user/{fid}	User by FID
GET	/api/social/farcaster/user/{fid}/casts	User casts by FID
GET	/api/social/farcaster/user/{fid}/followers	Followers by FID
GET	/api/social/farcaster/user/{fid}/following	Following by FID
GET	/api/social/farcaster/user/{fid}/storage	User storage usage
GET	/api/social/farcaster/username/{username}	User by username
GET	/api/social/farcaster/users/bulk	Bulk user lookup

Quick Start

# Example: /api/badges/\{name\}
curl -s "https://api.web3identity.com/api/badges/example" | jq