FarcasterChannels API

Learn all the detailed references of FarcasterChannels API that provide Farcaster channel participants information, including the input filters and output fields.

The FarcasaterChannels API fetches the details of Farcaster channels, which include data such as channel name, channel ID, description, image URI, participants, and more.

Inputs

filter

Name	Type	Description
channelId	String_Comparator_Exp	The channel ID, e.g. for /warpcast channel, the ID is "warpcast".
createdAtTimestamp	Time_Comparator_Exp	Creation timestamp of the channel.
leadId	Boolean_Comparator_Exp	The channel creator/original host's FIDs.
leadIdentity	Identity_Comparator_Exp	The channel creator/original host's web3 identities, either 0x address, Farcaster, or ENS. For more details, check out Airstack Identity API.
moderatorId	String_Comparator_Exp	Filter by any channel moderator FIDs If you are looking to filter by creators or original host's FIDs, then use leadId.
moderatorIdentity	Identity_Comparator_Exp	Filter by any channel moderator web3 identities. If you are looking to filter by creators or original host's web3 identities, then use leadIdentity.
name	Regex_String_Comparator_Exp	The name of the channel, not necessarily the same as the channel ID. It is the title that you see in the channel page, e.g. for /warpcast channel, the name is "Warpcast".

blockchain

For FarcasterChannelParticipants API, it will return all Farcaster channels.

You just need to specify the input to ALL for the query to work.

Enum	Description
ALL	-

order

Name	Description
createdAtTimestamp	Sort the result by the channel creation timestamp.
followerCount	Sort the result by the number of channel followers.

Output

Name	Type	Description
channelId	String	The channel ID, e.g. for /warpcast channel, the ID is "warpcast".
createdAtTimestamp	Time	The last timestamp when an action (either cast or reply) occur by a participant.
dappName	String	Dapp name. Currently, only supports Farcaster.
dappSlug	String	Dapp name. Currently, only supports farcaster_v2_optimism.
id	ID	Airstack unique identifier for the data point.
description	String	The channel description.
followerCount	Int	The number of followers of a channel.
imageUrl	String	The channel image URL.
isModerationEnabled	Boolean	To indicate whether any moderation is enabled on the channel.
leadIds	[String]	The original host's FIDs.
leadProfiles	[Socials]	Nested Query – The original host's profile details.
moderatorIds	[String]	All the moderator's FIDs.
moderatorProfiles	[Socials]	Nested Query – All the moderator's profile details.
name	String	The name of the channel, not necessarily the same as the channel ID. It is the title that you see in the channel page, e.g. for /warpcast channel, the name is "Warpcast".
participants	FarcasterChannelParticipants	Nested Query – associated participants details.
url	String	Warpcast URL to the channel.