Searching Casts
You can search for casts using keywords and operators in the search query.Authorizations
API key to authorize requests
Headers
Query Parameters
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 ) |
Example:
"star (wars | trek) \"space battle\" after:2024-05-04"
Choices are:
literal
- Searches for the words in the query string (default)semantic
- Searches for the meaning of the query stringhybrid
- Combines both literal and semantic results
Available options:
literal
, semantic
, hybrid
Example:
"literal"
Choices are:
desc_chron
- All casts sorted by time in a descending order (default)chron
- All casts sorted by time in ascending orderalgorithmic
- Casts sorted by engagement and time
Available options:
desc_chron
, chron
, algorithmic
Example:
"desc_chron"
Fid of the user whose casts you want to search
Required range:
x >= 1
Providing this will return search results that respects this user's mutes and blocks and includes viewer_context
.
Required range:
x >= 1
Parent URL of the casts you want to search
Channel ID of the casts you want to search
Number of results to fetch
Required range:
1 <= x <= 100
Example:
25
Pagination cursor
Response
Success
The response is of type object
.