Search Farcaster Casts
Search Farcaster casts by keyword or content. Supports filtering by author and channel. Returns cast text, engagement metrics, and metadata. Ideal for: brand monitoring, content discovery, sentiment analysis, keyword alerts.
Catalog action Social
Search Farcaster casts by keyword or content. Supports filtering by author and channel. Returns cast text, engagement metrics, and metadata. Ideal for: brand monitoring, content discovery, sentiment analysis, keyword alerts.
At a Glance
| Field | Value |
|---|---|
| Action ID | search-farcaster-casts |
| Category | Social |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | social, farcaster, neynar, cast, search, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search text to find in casts |
authorFid | number | No | Filter results by author FID |
channelId | string | No | Filter results by channel ID (e.g., 'base', 'ethereum') |
limit | number | No | Maximum number of results (default: 25, max: 100) |
cursor | string | No | Cursor for pagination (from nextCursor in previous response) |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
casts | array | Yes | Array of matching casts |
nextCursor | string | null | No | Cursor for next page of results |
Examples
json{ "type": "search-farcaster-casts", "payload": { "query": "status:open" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/search-farcaster-casts/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "query": "status:open" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.