Introduction

This actor extracts Posts in a List from Twitter. It captures full post content, engagement metrics like likes and views, and detailed author metadata from any feed, profile, or hashtag page. The scraper provides structured data for social media analysis and sentiment tracking.

Data Fields

Field Name	Description	Example
Post Text	The content of the tweet	"Hello world! #tech"
Post Date	Timestamp of publication	"2023-10-27T10:00:00.000Z"
Post URL	Direct link to the tweet	"https://x.com/user/status/123"
Post Language	BCP 47 language code	"en"
Post Views	Number of views	1500
Post Likes	Number of likes	45
Post Replies	Number of replies	12
Post Reposts	Number of reposts	8
Post Quotes	Number of quote tweets	3
Post Bookmarks	Number of bookmarks	5
Is Retweet	Boolean status for retweets	false
Author Name	Display name of the user	"John Doe"
Author Username	Handle of the user	"johndoe"
Author URL	Link to user profile	"https://x.com/johndoe"
Author Description	User bio text	"Software developer and blogger."
Author Location	User-defined location	"San Francisco, CA"
Author Followers	Count of followers	1200
Author Following	Count of following	300
Author Posts Count	Total posts by user	5000
Author Join Date	Account creation date	"2012-05-15"
Author Is Verified	Verification status	true
Author Profile Image	URL to profile picture	"https://pbs.twimg.com/profile_images/123.jpg"
Author Profile Banner	URL to banner image	"https://pbs.twimg.com/profile_banners/123.jpg"
Author Media Count	Total media items posted	450
All Media URLs	Array of media links	["https://pbs.twimg.com/media/xyz.jpg"]
Media Types	Types of media attached	["photo"]
Has Media	Boolean for media presence	true
Media Count	Number of media items	1
Is Reply	Boolean for reply status	false
Reply To User	Username of parent author	null
Is Quote Tweet	Boolean for quote status	false
Is Translatable	If translation is available	true
Is Editable	If the post can be edited	true
Edits Remaining	Number of edits left	5

Input

• urls: Array of Twitter URLs. Supports profile pages, hashtag pages, and home feeds.
• maxItems: Maximum number of posts to extract per URL. Default is 100.

Example Input

{
  "urls": ["https://x.com/search?q=technology"],
  "maxItems": 50
}

Example Output

[
  {
    "postText": "Exploring the future of AI.",
    "postDate": "2023-10-27T14:20:00.000Z",
    "postUrl": "https://x.com/tech_insider/status/987654321",
    "postLanguage": "en",
    "postViews": 12500,
    "postLikes": 340,
    "postReplies": 22,
    "postReposts": 55,
    "postQuotes": 10,
    "postBookmarks": 15,
    "isRetweet": false,
    "authorName": "Tech Insider",
    "authorUsername": "tech_insider",
    "authorUrl": "https://x.com/tech_insider",
    "authorDescription": "Daily tech news.",
    "authorLocation": "New York",
    "authorFollowers": 50000,
    "authorFollowing": 200,
    "authorPostsCount": 12000,
    "authorJoinDate": "2015-01-01",
    "authorIsVerified": true,
    "authorProfileImage": "https://pbs.twimg.com/profile_images/1.jpg",
    "authorProfileBanner": "https://pbs.twimg.com/profile_banners/1.jpg",
    "authorMediaCount": 2000,
    "allMediaUrls": ["https://pbs.twimg.com/media/img1.jpg"],
    "mediaTypes": ["photo"],
    "hasMedia": true,
    "mediaCount": 1,
    "isReply": false,
    "replyToUser": null,
    "isQuoteTweet": false,
    "isTranslatable": true,
    "isEditable": true,
    "editsRemaining": 5
  },
  {
    "postText": "Check out this sunset!",
    "postDate": "2023-10-27T18:05:00.000Z",
    "postUrl": "https://x.com/traveler/status/1122334455",
    "postLanguage": "en",
    "postViews": 500,
    "postLikes": 80,
    "postReplies": 5,
    "postReposts": 2,
    "postQuotes": 1,
    "postBookmarks": 2,
    "isRetweet": false,
    "authorName": "Traveler",
    "authorUsername": "traveler_99",
    "authorUrl": "https://x.com/traveler_99",
    "authorDescription": "Exploring the world.",
    "authorLocation": "London",
    "authorFollowers": 1500,
    "authorFollowing": 400,
    "authorPostsCount": 800,
    "authorJoinDate": "2018-06-10",
    "authorIsVerified": false,
    "authorProfileImage": "https://pbs.twimg.com/profile_images/2.jpg",
    "authorProfileBanner": "https://pbs.twimg.com/profile_banners/2.jpg",
    "authorMediaCount": 300,
    "allMediaUrls": ["https://pbs.twimg.com/media/img2.jpg"],
    "mediaTypes": ["photo"],
    "hasMedia": true,
    "mediaCount": 1,
    "isReply": false,
    "replyToUser": null,
    "isQuoteTweet": false,
    "isTranslatable": true,
    "isEditable": true,
    "editsRemaining": 5
  }
]

Want more from Twitter?

This actor only covers Posts in a List. The full Twitter Scraper browser extension also includes User Details, Users in a List, Trending Topics with unlimited personal use, real-time scraping with your logged-in sessions, CSV/Excel/JSON export, field customization, and scheduled monitoring.

Get the Twitter Scraper extension

Disclaimer: This tool extracts publicly available data. Users are responsible for compliance with applicable terms of service.