🐦 Twitter/X Inspiration Posts Scraper – Get Top Trending Content

Discover and extract top trending, highly viral Twitter/X posts based on engagement type, geographic region, and time period. Find inspiration, analyze viral patterns, monitor trending topics, and optimize your content strategy by analyzing the most popular posts. Perfect for content creators, copywriters, social media managers, growth hackers, and market researchers!

📋 Table of Contents

• Features
• Use Cases
• Quick Start
• Input Parameters
• Output Format
• Data Fields Explained
• FAQ

🚀 Features

Viral Post Discovery

• Engagement Types - Filter trending posts by highest Likes, Replies, Quotes, Bookmarks, Shares, or Video Views.
• Geographic Filtering - Get trending posts from specific regions: ALL, USA, FRA, or India.
• Time Periods - Retrieve the best performing content sorted by Daily, Weekly, or Monthly periods.
• Complete Author Metadata - Display name, username, user ID, high-resolution avatar image, description/bio, follower count, verified status, and engagement metrics.
• Detailed Interaction Stats - Get exact numbers for likes, retweets, replies, quote tweets, bookmarks, and views.

🎯 Use Cases

Use Case	Description	Benefits
Content Inspiration	Find what formats, hooks, and topics are currently going viral	Write better posts, copy proven viral templates
Trend Analysis	Keep track of daily, weekly, or monthly viral content by country	Identify shifts in public interest and hot topics
Growth Hacking	Analyze the structure, media type, and length of top performing posts	Improve organic reach and click-through rates
Influencer Sourcing	Locate authors who consistently write trending posts	Partner with highly engaging creators
Market Research	Track what subjects are generating maximum bookmarks and replies	Formulate data-driven content marketing plans

⚡ Quick Start

1️⃣ Discover Daily Viral Content in the USA

{
  "type": "Likes",
  "country": "USA",
  "period": "Daily"
}

2️⃣ Discover Weekly Bookmarked Posts in FRA

{
  "type": "Bookmarks",
  "country": "FRA",
  "period": "Weekly"
}

📊 Input Parameters

Configuration Options

Parameter	Type	Required	Description	Default
type	String	No	Sort metric for trending posts. Options: Likes, Replies, Quotes, Bookmarks, Shares, VideoQualityViews.	"Likes"
country	String	No	Geographic region. Options: ALL, USA, FRA.	"USA"
period	String	No	Time range filter. Options: Daily, Weekly, Monthly.	"Daily"

📤 Output Format

Trending Tweet Result Example

{
  "type": "tweet",
  "tweet_id": "1800000000000000000",
  "tweet_url": "https://x.com/creator_handle/status/1800000000000000000",
  "text": "10 productivity hacks that will save you 20 hours a week. A thread:",
  "screen_name": "creator_handle",
  "created_at": "Wed Jun 12 10:00:00 +0000 2026",
  "favorites": 45000,
  "retweets": 8200,
  "replies": 950,
  "quotes": 420,
  "bookmarks": 12500,
  "views": "1200000",
  "lang": "en",
  "source": "Twitter for iPhone",
  "conversation_id": "1800000000000000000",
  "author_id": "12345678",
  "author_name": "Growth Specialist",
  "author_username": "creator_handle",
  "author_avatar": "https://pbs.twimg.com/profile_images/12345678/avatar.jpg",
  "author_description": "Helping creators and builders scale their business online.",
  "author_followers": 98000,
  "author_friends": 350,
  "author_favourites": 4500,
  "author_verified": true,
  "author_location": "New York, USA",
  "in_reply_to": null,
  "quoted_from": null,
  "possibly_sensitive": false,
  "media": null,
  "search_type": "Likes",
  "search_country": "USA",
  "search_period": "Daily",
  "scraped_at": "2026-07-08T10:45:00.000Z"
}

📈 Data Fields Explained

Complete Field Reference

Field	Type	Description
tweet_id	String	Unique status ID of the trending tweet.
tweet_url	String	Direct link to view the tweet on X.com.
text	String	The text content of the tweet.
screen_name	String	Handle of the user who posted the tweet.
created_at	String	Original post timestamp.
favorites	Integer	Favorite / like count.
retweets	Integer	Retweet count.
replies	Integer	Reply count.
quotes	Integer	Quote tweet count.
bookmarks	Integer	Bookmark count.
views	String/Number	View count / impressions.
author_id	String	Unique user ID of the post author.
author_name	String	Display name of the author.
author_username	String	Username/handle of the author.
author_avatar	String	Avatar image URL of the author.
author_followers	Integer	Follower count of the author.
author_verified	Boolean	True if the creator has a verified badge.
search_type	String	The sorting type requested in inputs.
search_country	String	The country requested in inputs.
search_period	String	The time period requested in inputs.
scraped_at	String	Extraction timestamp.

❓ FAQ

Q: Where does the "Inspiration Posts" data come from?

A: The data represents real-time trending posts curated by the underlying API, highlighting top performing content across various niches.

Q: Can I check historical trends beyond Monthly?

A: The API supports Daily, Weekly, and Monthly periods. The results reflect the top posts active during those periods.

---

Related Actors 🤝

• Twitter X Thread Reader Scraper
• Twitter X Recent Replies Scraper
• Twitter X Lists Timeline Scraper
• Twitter X Profile Scraper
• Twitter X Video Downloader
• X Profile Viewer
• X Follower Scraper
• X Following Scraper
• Twitter Affiliates X Scraper

---

🏷️ Keywords & Tags

twitter inspiration posts, trending tweets scraper, viral x posts, twitter trending content, twitter copywriting tools, viral content discovery, social media inspiration, apify twitter scraper, trending content explorer

---

🚀 Get Started Now

1. Click "Try for free" to run this actor in the Apify Console.
2. Select your desired Engagement Type, Country, and Period.
3. Start the run and discover top viral content in seconds!
4. Download the results in JSON, CSV, or Excel format.

⭐ If this actor is useful to your workflow, please leave a star!

---

Built by Sachin Kumar Yadav using Apify Platform