> For the complete documentation index, see [llms.txt](https://falah.gitbook.io/byethost-support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://falah.gitbook.io/byethost-support/twitter-back-documentation.md).

# Twitter back - Documentation

**Version:** 2.0v\
**Author:** [@0xFaLaH](https://twitter.com/0xFaLaH)\
**Language:** Python 3\
**Platform:** Windows / Linux\
**Purpose:** Recover **deleted tweets** from any public Twitter account by fetching archived copies via the Wayback Machine.

<figure><img src="https://sp-ao.shortpixel.ai/client/to_auto,q_lossless,ret_img/https://bye-thost.com/wp-content/uploads/2023/05/7543f43f-5c46-4e2a-bef8-1a108e83dfbb-scaled.jpeg" alt="" width="375"><figcaption><p><a href="https://bye-thost.com/product/twitter_back/">https://bye-thost.com/product/twitter_back</a></p></figcaption></figure>

### 💡 What Does It Do?

Twayback retrieves **recently deleted tweets** (text, video, or both) from **any Twitter handle**, even if:

* The username was changed
* The account was suspended or deleted
* The tweet was removed manually

It uses `web.archive.org` to fetch backups and can optionally **download the video, text, or screenshots**.

***

### 🧰 Setup Instructions

#### ✅ Step 1: Open terminal and navigate to the tool folder

```bash
cd Twitter-Back
```

#### ✅ Step 2: Install dependencies

```bash
pip3 install -r requirements.txt
```

#### ✅ Step 3: Run the tool

```bash
python3 twayback.py
```

***

### 🛠 Usage Examples

Basic usage:

```bash
python3 twayback.py -u falah
```

Specify a **starting date** (format: `YYYY-MM-DD`):

```bash
python3 twayback.py -u falah -from 2022-01-05
```

Specify an **ending date**:

```bash
python3 twayback.py -u falah -to 2022/02/09
```

Specify **both a date range**:

```bash
python3 twayback.py -u falah -from 2020-08-30 -to 2020-09-15
```

Use with a **proxy list file**:

```bash
python3 twayback.py -u falah --proxy-file proxy.txt
```

***

### 🔍 Features

* ✅ Search deleted tweets via Wayback Machine
* 📥 Download tweet **videos**, **text**, or both
* 📸 Option to take **screenshots** of deleted tweets
* 🔁 Supports rotating proxy servers for better stability
* 🗂 Exports results to a **CSV file**
* 🧠 Async scraping for speed and performance

***

### 📄 Output

* A folder named after the username will be created.
* Results will be saved to:
  * `username/username.csv`
  * Any downloaded files will be saved in the same folder.

***

### 🎯 Post Search Options

After tweets are found, you can choose what to do with them:

* `text` – Save text content only
* `download` – Download any available media (video)
* `both` – Do both of the above
* `screenshot` – Take screenshots of the archived tweets

***

### ⚠️ Notes

* If you see `Error 429`, you are being rate-limited by Twitter — **use rotating proxies**.
* Use `-from` and `-to` to narrow your search and speed up the process.
* Results may be incomplete if the tweet was never archived.

***

### 🧪 Proxy Usage

To use proxies, create a `proxy.txt` file with one proxy per line, like:

```
123.45.67.89:8080
98.76.54.32:3128
```

Then run:

```bash
python3 twayback.py -u targetuser --proxy-file proxy.txt
```

***

### 📬 Support

* 👻 Snapchat: flaah999
* 🌐 Website: <https://bye-thost.com>
* 📧 **Email**: <support@bye-thost.com>

***