v1
latestOpenAPI 3.0.42026-07-26159287356.1 KBCast
Search for casts
Search for casts based on a query string, with optional AND filters
get/v2/farcaster/cast/search/
Query parameters
qstring required
Example:star (wars | trek) "space battle" after:2024-05-04
Query string to search for casts. Supported operators:
| Operator | Description |
|---|---|
| + | Acts as the AND operator. This is the default operator between terms and can usually be omitted. |
| | | Acts as the OR operator. |
| * | When used at the end of a term, signifies a prefix query. |
| " | Wraps several terms into a phrase (for example, "star wars"). |
| (, ) | Wrap a clause for precedence (for example, star + (wars | trek)). |
| ~n | When used after a term (for example, satr~3), sets fuzziness. When used after a phrase, sets slop. |
| - | Negates the term. |
| before: | Search for casts before a specific date. (e.g. before:2025-04-20 or before:2025-04-20T23:59:59) |
| after: | Search for casts after a specific date. (e.g. after:2025-04-20 or after:2025-04-20T00:00:00) |
mode'literal' | 'semantic' | 'hybrid'
Example:literal
Choices are:
- literal - Searches for the words in the query string (default)
- semantic - Searches for the meaning of the query string
- hybrid - Combines both literal and semantic results
sort_type'desc_chron' | 'chron' | 'algorithmic'
Example:desc_chron
Choices are:
- desc_chron - All casts sorted by time in a descending order (default)
- chron - All casts sorted by time in ascending order
- algorithmic - Casts sorted by engagement and time
author_fidinteger
Fid of the user whose casts you want to search
viewer_fidinteger
Providing this will return search results that respects this user's mutes and blocks and includes viewer_context.
parent_urlstring
Parent URL of the casts you want to search
channel_idstring
Channel ID of the casts you want to search
limitinteger
Example:25
Number of results to fetch
cursorstring
Pagination cursor
Headers
x-neynar-experimentalboolean
Enables experimental features including filtering based on the Neynar score. See docs for more details.
Response
Success