Skip to main content

Farcaster Data

Decentralized social network data from the Farcaster protocol for Web3 social intelligence and protocol analytics. The Farcaster data share provides comprehensive access to casts, profiles, channels, and engagement metrics from the decentralized social network. Perfect for tracking Web3 narratives, monitoring community sentiment, and analyzing protocol adoption.

Update Frequency: On-demand

What's Included

This data is collected by Heisenberg nodes running the data agent and organized into the following structure.

Cast Data

Posts (casts) with full content and threads:

Field NameTypeNullableDescription
idstringNoUnique cast identifier
contenttextNoFull cast text content
authorstringNoUser who created the cast
author_idstringNoUnique author identifier
created_attimestampNoCast timestamp
urlstringNoDirect link to the cast
parent_idstringYesParent cast for replies
thread_idstringYesThread identifier
reactionsobjectYesLikes, recasts, and other reactions
reply_countintegerNoNumber of replies
recast_countintegerNoNumber of recasts
mediaarrayYesAttached media files

Profile Information

User profiles and follower relationships:

Field NameTypeNullableDescription
user_idstringNoUnique user identifier
usernamestringNoFarcaster username
display_namestringYesDisplay name
biotextYesUser biography
avatarstringYesProfile image URL
follower_countintegerNoNumber of followers
following_countintegerNoNumber of following
verification_statusbooleanNoVerification badge status
created_attimestampNoAccount creation date

Channel Data

Channel topics and membership:

Field NameTypeNullableDescription
channel_idstringNoUnique channel identifier
channel_namestringNoChannel name
descriptiontextYesChannel description
member_countintegerNoNumber of members
activity_metricsobjectYesPosts, engagement, growth
trending_statusbooleanNoWhether channel is trending

Engagement Metrics

Cast and network engagement data:

Field NameTypeNullableDescription
cast_idstringNoAssociated cast identifier
likesintegerNoNumber of likes
recastsintegerNoNumber of recasts
repliesintegerNoNumber of replies
engagement_ratefloatYesCalculated engagement rate
trending_scorefloatYesTrending algorithm score

Additional Features

FeatureBenefit
Real-time UpdatesData refreshes multiple times per day, ensuring you always have the latest casts and engagement data
Thread DetectionAutomatically identifies conversation threads and reply chains for context analysis
Media ExtractionSeparate fields for images, videos, and other media attachments
Engagement MetricsComprehensive engagement data including likes, recasts, and replies
Channel TrackingChannel-level data for tracking community activity and trends
Profile AnalyticsUser-level data for tracking key voices and their impact
Decentralized ContextFull protocol-level data for understanding decentralized social dynamics
Structured FormatClean, normalized data ready for immediate use in AI applications

On-Demand Context Generation

Want to create custom context pipelines from this Farcaster data? You can generate on-demand context tailored to your specific needs using our COOK platform. COOK allows you to build personalized Data Agents that process, filter, and transform this Farcaster data into custom insights perfect for your AI applications. Create context pipelines that combine Farcaster data with other sources, apply custom filters, and generate structured outputs that match your exact requirements.

📖 Learn more about COOK →

Integration

Access Methods

REST API - Query casts, profiles, and channels programmatically

MCP Integration - Plug directly into AI agents and multi-cloud workflows

Direct Database Access - PostgreSQL connection for custom analytics

Example Queries

Filter by:

  • Channel - Specific channels
  • User - Specific accounts
  • Time range - Recent casts or date ranges
  • Keywords - Search in cast content
  • Engagement threshold - Minimum likes, recasts
  • Thread - Specific conversation threads

Analyze by:

  • Trending casts - Highest engagement or fastest growth
  • Channel activity - Most active channels
  • User influence - Key voices and their impact
  • Topic trends - Emerging discussions and themes

Next Steps

Ready to integrate Farcaster data into your application?