Pricing
Pay per event
Protocol-native Farcaster data ingestion for research, analytics, and social graph analysis. Collect casts, reactions, follows, user profiles, and real-time events directly from Farcaster Hubs via HTTP API.
Pricing
Pay per event
Rating
5.0
(2)
Developer
BarriereFix
Actor stats
1
Bookmarked
4
Total users
1
Monthly active users
24 days ago
Last modified
Categories
Share
hubBaseUrlstringRequired
HTTP endpoint of your Farcaster Hub (e.g., https://hub.pinata.cloud)
Default value of this property is "https://hub.pinata.cloud"
modeEnumRequired
Choose how to collect data
"byFids": string"byTime": string"tailEvents": stringDefault value of this property is "byFids"
fidsarrayOptional
List of Farcaster IDs (integers). Used in byFids/byTime modes. Example: [2, 3] for Farcaster founders.
Default value of this property is [2,3]
discoverFidsbooleanOptional
If enabled, enumerate FIDs from specified shards (slower but comprehensive)
Default value of this property is false
shardIdsarrayOptional
Which shards to scan when discoverFids=true (e.g., [0,1,2])
Default value of this property is []
startTimestampintegerOptional
Epoch seconds since 2021-01-01. Optional; used for time-bounded ingestion.
stopTimestampintegerOptional
Epoch seconds. Leave empty for 'now'.
includeobjectOptional
Toggle which data types to collect
Default value of this property is {"casts":true,"reactions":true,"links":true,"userData":true}
tailobjectOptional
Incremental streaming config
Default value of this property is {}
fetchEmbedsbooleanOptional
Fetch and parse fc:miniapp / fc:frame meta tags from cast embeds
Default value of this property is false
maxEmbedsPerRunintegerOptional
Safety cap for embedded URL crawling
Default value of this property is 500
clientApibooleanOptional
Experimental. Queries api.farcaster.xyz for non-protocol features.
Default value of this property is false
neynarApiKeystringOptional
If provided, use Neynar's hosted Hub endpoints (v2 only; v1 EOL Mar 31, 2025)
pageSizeintegerOptional
Records per page (Hub max 1000)
Default value of this property is 1000
maxRecordsintegerOptional
Stop after N records. Leave empty for unlimited.
Default value of this property is 100