Twitter User Timeline Scraper

Twitter User Timeline Scraper helps you quickly collect the latest tweets from any public X user by username. It is ideal for marketers, researchers, analysts, journalists, and social media teams who need fresh Twitter/X timeline data without manual scrolling. Use it to capture tweet text, timestamps, engagement counts, media, author details, and pagination data in one place. If you want a simple way to monitor a public profile and export tweet data for analysis, this actor gives you a fast, reliable starting point.

Key Features

• Extract the newest tweets from a single public X account by username.
• Collect older tweets automatically when you want to go beyond the first page of results.
• Preserve the timeline data exactly as returned, so you can review the original tweet details and metadata.
• Capture engagement signals such as likes, replies, reposts, quotes, bookmarks, and views.
• Include rich tweet context like author information, media, mentions, and retweeted content when available.
• Support ongoing monitoring workflows by letting you continue from a saved cursor.
• Export results in a format that is easy to analyze, share, or load into your reporting workflow.

Use Cases

Social Media Monitoring

Social media managers use this actor to keep an eye on a brand, executive, competitor, or creator account. By collecting tweet text, created time, and engagement metrics like favorites, replies, retweets, and views, they can spot what content is gaining traction and react faster.

Competitor Research

Growth teams and analysts can compare how different public accounts communicate, post frequency, and audience response. Fields such as tweet text, source, language, and engagement counts help them understand messaging patterns and identify content that performs well.

Content Performance Analysis

Creators and marketing teams often want to know which posts drive the most attention. This actor returns the raw tweet data, including bookmarks, quotes, replies, retweets, and views, so teams can review performance trends and build better content strategies.

Media and Journalism Research

Journalists and researchers can use the timeline data to document what a public figure posted and when they posted it. The created_at timestamp, conversation_id, and author details make it easier to verify timelines, track public statements, and reference original posts accurately.

Audience and Brand Intelligence

Brand and communications teams can study how a public account presents itself and how audiences respond. The output includes author profile details, profile image, follower count, pinned posts, and tweet metadata, which helps teams understand account positioning and public reach.

Repost and Mention Tracking

Teams that track conversations around a topic can inspect retweeted posts and user mentions inside the timeline data. This is useful for identifying which accounts are being amplified, who is being mentioned, and how a public profile participates in broader discussions.

Input

Field	Type	Required	Description	Example
cursor	string	No	A saved position that lets you continue from a previous page of results.	cursor123
screenname	string	string	Yes	The Twitter/X username whose timeline you want to fetch.
max_results	integer	No	The maximum number of tweets to collect before stopping.	100

Output

Field	Type	Description
tweet_id	string	The unique ID of the tweet, useful for tracking or referencing a specific post.
bookmarks	number	How many times the tweet was bookmarked, which can indicate strong interest.
created_at	string	The date and time the tweet was posted.
favorites	number	How many likes the tweet received.
text	string	The tweet content exactly as posted, including links or shortened text.
lang	string	The language of the tweet.
source	string	The app or device used to publish the tweet.
views	string	The number of views shown for the tweet.
quotes	number	How many times the tweet was quoted.
replies	number	How many replies the tweet received.
retweets	number	How many times the tweet was reposted.
conversation_id	string	The ID that groups the tweet with its conversation thread.
media	object	Media attached to the tweet, such as photos or other visual content.
author	object	Basic information about the account that posted the tweet.
type	string	The kind of timeline item, such as a normal post or a pinned post.
user	object	Profile details for the account whose timeline was collected.
entities	object	Extra tweet details such as mentioned accounts, when available.
retweeted	object	Information about the original tweet when the item is a repost.
retweeted_tweet	object	The full details of the original tweet that was reposted, when available.

Sample Output

{
  "tweet_id": "2073311697474076672",
  "bookmarks": 6761,
  "created_at": "Sat Jul 04 07:43:23 +0000 2026",
  "favorites": 394954,
  "text": "God Bless America https://t.co/ffqS5KzKB5",
  "lang": "en",
  "source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>",
  "views": "13075094",
  "quotes": 1997,
  "replies": 21360,
  "retweets": 32416,
  "conversation_id": "2073311697474076672",
  "media": {
    "photo": [
      {
        "media_url_https": "https://pbs.twimg.com/media/HMXiAEJaoAAR4xI.jpg",
        "id": "2073311694215094272",
        "sizes": {
          "h": 797,
          "w": 1152
        }
      }
    ]
  },
  "author": {
    "rest_id": "44196397",
    "name": "Elon Musk",
    "screen_name": "elonmusk",
    "avatar": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg",
    "followers_count": 240728548,
    "blue_verified": true
  },
  "type": "pinned_post",
  "user": {
    "status": "active",
    "profile": null,
    "rest_id": "44196397",
    "blue_verified": true,
    "verification_type": null,
    "affiliates": {
      "label": {
        "badge": {
          "url": "https://pbs.twimg.com/profile_images/1955359038532653056/OSHY3ewP_bigger.jpg"
        },
        "description": "X",
        "url": {
          "url": "https://twitter.com/X",
          "urlType": "DeepLink"
        },
        "userLabelDisplayType": "Badge",
        "userLabelType": "BusinessLabel"
      }
    },
    "business_account": [],
    "avatar": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg",
    "header_image": "https://pbs.twimg.com/profile_banners/44196397/1774145451",
    "desc": "Starmind",
    "name": "Elon Musk",
    "protected": false,
    "location": "",
    "friends": 1366,
    "sub_count": 240728408,
    "statuses_count": 105263,
    "media_count": 4589,
    "created_at": "Tue Jun 02 20:12:29 +0000 2009",
    "pinned_tweet_ids_str": [
      "2073311697474076672"
    ],
    "id": "44196397"
  }
}

How It Works

1. You enter the public X username you want to review.
2. The actor fetches the latest tweets from that account automatically.
3. If you want more history, it continues loading older tweets until it reaches your limit.
4. The actor keeps the tweet data in its original structure so you can inspect it without losing detail.
5. When the run finishes, you can review and export the results for your workflow.

Getting Started

Getting started is simple and does not require coding knowledge. Click Try for free, enter the username you want to collect, choose how many tweets you want, and click Run. The actor will gather the timeline data for you and return it in a format that is easy to work with. You can download the results as JSON, CSV, or Excel depending on how you want to analyze or share them.

Frequently Asked Questions

Do I need technical skills?

No. This actor is designed for business users, researchers, and marketers who want tweet data without building anything themselves. Just enter a username, choose your limit, and run it.

How fast does it run?

Speed depends on how many tweets you request and whether the actor needs to continue loading older posts. Smaller requests usually finish quickly, while larger timelines take longer because more data is being collected.

What format is the output?

The results are available in formats that are easy to use for reporting and analysis, including JSON, CSV, and Excel. The actor also preserves the original timeline structure so you can keep the full context of each tweet.

Is this legal to use?

This actor is intended for collecting publicly available timeline data from public X accounts. You should always make sure your use complies with applicable laws, platform rules, and your own internal policies, especially if you plan to store, analyze, or republish the data.

Can I schedule it to run automatically?

Yes. You can use Apify scheduling and automation features to run it on a regular basis. That makes it easy to monitor a public account over time and keep your dataset fresh without manual work.