Skip to main content

​
Overview

The favorites command fetches tweets you’ve bookmarked (saved) on Twitter. Bookmarks are private and only visible to you.

​
Syntax

twitter favorites [OPTIONS]

​
Options

​
--max
integer
Maximum number of bookmarked tweets to fetch. If not specified, uses the default from your config file (typically 50).Alias: -n
​
--json
boolean
Output tweets as JSON instead of formatted table.
​
--output
string
Save fetched bookmarks to a JSON file.Alias: -o
​
--filter
boolean
Enable score-based filtering to organize bookmarks by quality score.

​
Examples

# Fetch your bookmarked tweets
twitter favorites

​
Output

The command displays a formatted table showing:
  • Tweet content and author
  • Engagement metrics (likes, retweets, replies)
  • Tweet timestamps
  • Filter statistics (when --filter is used)

​
Example Output

🔐 Getting Twitter cookies...
🔖 Fetching favorites (50 tweets)...

✅ Fetched 50 favorites in 1.8s

🔖 favorites — 50 tweets
┏━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━┳━━━━━━┳━━━━━━┓
┃ Author      ┃ Tweet                 ┃ ❤️    ┃ 🔄   ┃ 💬   ┃
┡━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━╇━━━━━━╇━━━━━━┩
│ @sama       │ Great insight on...   │ 892  │ 123  │ 45   │
│ @karpathy   │ New paper on...       │ 2.1k │ 345  │ 167  │
└─────────────┴───────────────────────┴──────┴──────┴──────┘
Bookmarks are fetched in reverse chronological order (most recent first).
Use favorites with --output to create a backup of your bookmarks:
twitter favorites -n 1000 -o bookmarks_backup.json
You can later search or filter this archive offline.

​
Use Cases

  • Archive bookmarks - Save your bookmarks before they’re deleted
  • Organize saved content - Use filtering to find your best bookmarks
  • Export for research - Extract bookmarked tweets for analysis or note-taking
  • Backup important tweets - Create local copies of valuable content
  • feed - View your home timeline
  • search - Search for specific tweets
  • tweet - View a specific tweet and its replies

Build docs developers (and LLMs) love

Get started for freeTalk to us