Pricing

Rating

Developer

Actor stats

Categories

Share

X (Twitter) User Timeline Actor

This Apify Actor scrapes user timelines from X (Twitter) to extract tweets, user information, and engagement metrics. It works in guest mode without requiring authentication and can retrieve tweets from any public Twitter account.

Features

• Timeline scraping - Extract tweets from any public X (Twitter) user timeline
• User information - Retrieve user profile data including verification status
• Engagement metrics - Get retweet, like, and reply counts for each tweet
• Media detection - Identify tweets with attached media (images, videos)
• Guest mode operation - Works without authentication requirements
• Proxy support - Uses Apify's residential proxy for reliable requests
• Structured output - Results include comprehensive tweet and user data
• Configurable limits - Control the number of tweets retrieved

Input Parameters

Example Input

{
"username":"elonmusk",
"count":10,
"includeReplies":false,
"includeRetweets":true
}

How It Works

1. The actor validates the input parameters (username and count)
2. It initializes a proxy configuration using Apify's residential proxy
3. It fetches the user's timeline page from X (Twitter)
4. It parses the HTML to extract tweet data, user information, and engagement metrics
5. Results are pushed to the dataset with structured tweet and user information

Output

The actor outputs a structured object containing:

{
"username":"elonmusk",
"user_id":"44196397",
"tweet_count":20,
"tweets":[
{
"id":"1234567890",
"text":"Tweet content here",
"created_at":"2025-07-07T12:34:56",
"retweet_count":1000,
"favorite_count":5000,
"reply_count":200,
"is_retweet":false,
"is_reply":false,
"user":{
"id":"44196397",
"name":"Elon Musk",
"screen_name":"elonmusk",
"verified":true
},
"media":[
{
"type":"photo",
"url":"https://pbs.twimg.com/media/example.jpg"
}
]
}
]
}

Example Usage

Get Elon Musk's Timeline

{
"username":"elonmusk",
"count":10
}

Get Timeline with Replies

{
"username":"nasa",
"count":20,
"includeReplies":true,
"includeRetweets":false
}

Limitations

• Works in guest mode, so some data may be limited compared to authenticated access
• Rate limiting may apply based on Twitter's policies
• Some tweets or media might not be accessible in guest mode
• Private accounts cannot be scraped