Twitter Timeline Scraper

Overview

This actor scrapes the public timeline of any Twitter user via the Twitter API. It returns an array of tweet objects with detailed metadata, including content, engagement metrics, media attachments, and author information.

Key Features

• Fetches tweets from a specified public user timeline.
• Supports pagination to automatically collect tweets up to a defined maximum.
• Returns comprehensive data for each tweet: ID, timestamp, text, likes, retweets, replies, quotes, views, language, source, media (photos/videos), and author details.

How to Use

Provide the target Twitter username and the maximum number of tweets you want to collect. The actor handles pagination automatically, stopping when it reaches the maxResults limit or when no more tweets are available.

Input

Configure the actor with the following input fields:

Output

The output is a JSON array of tweet objects. Each object contains a detailed set of fields. The structure of a typical tweet in the output is shown below.

{
  "tweet_id": "1927977858812760412",
  "created_at": "Thu May 29 06:38:36 +0000 2025",
  "text": "https://t.co/CSwbjnzNao",
  "favorites": 24255,
  "retweets": 3061,
  "replies": 2367,
  "quotes": 224,
  "views": "1781258",
  "lang": "zxx",
  "source": "<a href=\"http://twitter.com/download/iphone\" rel=\"nofollow\">Twitter for iPhone</a>",
  "media": {
    "video": [
      {
        "media_url_https": "https://pbs.twimg.com/ext_tw_video_thumb/1796190801073950721/pu/img/GFLwceK_ddA8a1sJ.jpg",
        "variants": [...],
        "duration": 41770
      }
    ]
  },
  "author": {
    "rest_id": "44196397",
    "name": "Elon Musk",
    "screen_name": "elonmusk",
    "avatar": "https://pbs.twimg.com/profile_images/1926284313365979137/o2cF3MeJ_normal.jpg",
    "blue_verified": true
  },
  "scrapedAt": "2025-05-29T09:02:38.547Z"
}

Notes

• This actor only works with public Twitter timelines.