**Options:**
| Option | Description |
|--------|-------------|
| `--sort` | `Top` (default) or `Latest` |
| `--user`, `-u` | Filter to posts by username |
| `--start-date` | Start date UTC (YYYY-MM-DD) |
| `--end-date` | End date UTC (YYYY-MM-DD) |
| `--lang` | Language code (e.g. `en`, `es`) |
| `--verified` | Only verified users |
| `--blue-verified` | Only Twitter Blue users |
| `--is-quote` | Only quote tweets |
| `--is-video` | Only posts with video |
| `--is-image` | Only posts with images |
| `--min-retweets` | Minimum retweet count |
| `--min-replies` | Minimum reply count |
| `--min-likes` | Minimum like count |
| `--count`, `-n` | Results count (default: 20, max: 100) |

**Response:** `Tweet[]`


### `x_post` — Retrieve Post by ID

Fetch a single post by its numeric ID.

**Response:** `Tweet`


### `x_urls` — Fetch Posts by URLs

Retrieve one or more posts by their X URLs.

**Response:** `Tweet[]`


### `x_user` — Search Posts by User

Search within a specific user's posts for a keyword.

**Options:**
| Option | Description |
|--------|-------------|
| `--query`, `-q` | Keyword to filter the user's posts |
| `--count`, `-n` | Results count (default: 10, max: 100) |

**Response:** `Tweet[]`


### `x_timeline` — Get User Timeline

Fetch the most recent posts from a user's timeline. Retweets include a `retweet` field with the original post.

**Options:**
| Option | Description |
|--------|-------------|
| `--count`, `-n` | Number of posts (default: 20, max: 100) |

**Response:** `{ user: User, tweets: Tweet[] }`


### `x_retweeters` — Get Retweeters of a Post

List users who retweeted a specific post. Supports cursor-based pagination.

**Options:**
| Option | Description |
|--------|-------------|
| `--cursor` | Pagination cursor from a previous response |

**Response:** `{ users: User[], next_cursor: string|null }` — `next_cursor` is `null` when no more pages remain.


### `x_replies` — Get User's Replies

Fetch a user's tweets-and-replies timeline. Replies have `in_reply_to_screen_name` and `in_reply_to_status_id` set.

**Options:**
| Option | Description |
|--------|-------------|
| `--count`, `-n` | Results count (default: 10, max: 100) |
| `--query`, `-q` | Filter keyword |

**Response:** `Tweet[]`


### `x_post_replies` — Get Replies to a Post

Fetch replies to a specific post by ID.

**Options:**
| Option | Description |
|--------|-------------|
| `--count`, `-n` | Results count (default: 10, max: 100) |
| `--query`, `-q` | Filter keyword within replies |

**Response:** `Tweet[]`

### Errors
Status 401, Unauthorized (e.g., missing/invalid API key)

scripts/desearch.py x "Bittensor TAO" --sort Latest --count 10
scripts/desearch.py x "AI news" --user elonmusk --start-date 2025-01-01
scripts/desearch.py x "crypto" --min-likes 100 --verified --lang en

{
  "detail": "Invalid or missing API key"
}