Skip to main content

​
Overview

The list command fetches tweets from a Twitter List. Lists are curated groups of Twitter accounts that let you view a custom timeline of tweets from specific users.

​
Syntax

twitter list LIST_ID [OPTIONS]

​
Arguments

​
LIST_ID
string
required
The numeric ID of the Twitter List to fetch tweets from.You can find the List ID in the URL when viewing a list: https://twitter.com/i/lists/1234567890 → List ID is 1234567890

​
Options

​
--max
integer
default:"20"
Maximum number of tweets to fetch from the list.Alias: -n
​
--json
boolean
Output tweets as JSON instead of formatted table.
​
--filter
boolean
Enable score-based filtering to show only high-quality tweets from the list.

​
Examples

# Fetch tweets from a list
twitter list 1234567890

​
Output

The command displays a formatted table with:
  • Tweet content and author
  • Engagement metrics (likes, retweets, replies)
  • Timestamps
  • Filter statistics (when using --filter)

​
Example Output

🔐 Getting Twitter cookies...
📋 Fetching list 1234567890 (20 tweets)...

✅ Fetched 20 list 1234567890 in 1.4s

📋 list 1234567890 — 20 tweets
┏━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━┳━━━━━━┳━━━━━━┓
┃ Author      ┃ Tweet                  ┃ ❤️    ┃ 🔄   ┃ 💬   ┃
┡━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━╇━━━━━━╇━━━━━━┩
│ @paulg      │ Startup advice:...     │ 1.2k │ 234  │ 67   │
│ @naval      │ Building wealth...     │ 3.4k │ 456  │ 123  │
│ @sama       │ AI developments...     │ 2.1k │ 345  │ 89   │
└─────────────┴────────────────────────┴──────┴──────┴──────┘

​
Finding List IDs

To get the List ID:
  1. On Twitter/X web - Go to your Lists page
  2. Click on a list - The URL will show the List ID: 
    https://twitter.com/i/lists/1234567890
                           ^^^^^^^^^^^
                           This is the List ID
  3. For other users’ lists - The URL format is the same: 
    https://twitter.com/i/lists/1234567890
You need to have access to view the list. Public lists can be viewed by anyone, while private lists are only accessible to members.
Lists are great for creating focused feeds around specific topics or communities:
# Tech leaders list
twitter list 1234567890 -n 100 --filter

# News outlets list
twitter list 9876543210 -n 50
Use --filter to surface the best content from your curated lists.

​
Use Cases

  • Curated feeds - View tweets from hand-picked accounts without following everyone
  • Topic monitoring - Create lists around specific interests or industries
  • Competitor tracking - Monitor tweets from competitors in one feed
  • News aggregation - Combine multiple news sources into one timeline
  • Research - Gather tweets from experts in a specific field
  • Community engagement - Track tweets from your community members

​
Managing Lists

While this CLI tool focuses on reading list timelines, you can manage your lists (create, edit, add members) through:
  • The Twitter/X web interface at twitter.com/i/lists
  • The Twitter mobile app
  • The Twitter API (for programmatic management)

​
List vs Feed

Here’s when to use each command:
Featuretwitter listtwitter feed
ContentSpecific list membersEveryone you follow
CurationManual selectionBased on follows
AlgorithmChronologicalAlgorithmic (for-you) or chronological (following)
Use caseFocused topicsGeneral browsing

Build docs developers (and LLMs) love

Get started for freeTalk to us