> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neynar.com/llms.txt
> Use this file to discover all available pages before exploring further.

# searchCasts

Search for casts

> **Group:** Cast APIs

Use this when you need: **Search for casts**.

## Usage

```ts theme={"system"}
import { NeynarAPIClient, Configuration } from "@neynar/nodejs-sdk";

const client = new NeynarAPIClient(
  new Configuration({ apiKey: "YOUR_NEYNAR_API_KEY" })
);

const res = await client.searchCasts({
  q: "example", // 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`)         |
  // xNeynarExperimental: true, 
  // mode: "value", 
  // sortType: "value", 
  // authorFid: 123, 
  // viewerFid: 123, 
  // parentUrl: "example", 
  // channelId: "example", 
  // limit: 123, 
  // cursor: "example", 
});
console.log(res);
```

## Parameters

| Parameter | Type | Required | Description | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| - | - | :-: | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - | - |
| `q` | `string` | ✅ | 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\`) | |
| `xNeynarExperimental` | `boolean` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `mode` | `SearchCastsModeEnum` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `sortType` | `SearchCastsSortTypeEnum` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `authorFid` | `number` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `viewerFid` | `number` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `parentUrl` | `string` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `channelId` | `string` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `limit` | `number` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
| `cursor` | `string` | ❌ | - | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

## Response

Returns a `RequestArgs` object.

## Error Handling

```ts theme={"system"}
try {
  const res = await client.searchCasts({
    q: "example"
  });
  // use res
} catch (err) {
  // Axios/HTTP errors, invalid params, auth issues, etc.
  console.error(err);
}
```

## Related API Reference

📖 **API Reference:** [searchCasts](/reference/search-casts)

For detailed information about the HTTP endpoint, request/response schemas, and additional examples, see the complete API documentation.

## Tips

* Provide a **viewerFid** when supported to respect mutes/blocks and include `viewer_context`.
* Keep requests scoped (e.g., use `limit`) to improve latency.
* Cache results where sensible.


## Related topics

- [SDK v1 to v2 migration guide](/reference/neynar-nodejs-sdk-v1-to-v2-migration-guide.md)
- [Search for casts](/reference/search-casts.md)
- [Metrics for casts](/reference/fetch-cast-metrics.md)
- [Search for Usernames](/reference/search-user.md)
- [fetchCastMetrics](/nodejs-sdk/metric-apis/fetchCastMetrics.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.