Twitter/X Global Trending Tweets Scraper

Collect currently trending tweets from Twitter/X by country, with optional topic and content filters. This Apify Actor returns clean tweet records that are ready for analysis, monitoring, dashboards, automations, and AI workflows.

What This Actor Does

This Actor fetches global trending tweet data from Twitter/X for a selected country or region. You can optionally narrow the results by topic or content tag, then export the returned tweets from Apify as JSON, CSV, Excel, or through the Apify API.

It is useful when you want to monitor what is gaining attention on X without building your own Twitter/X scraping system or using an official X developer account.

Key Features

• Fetch trending tweets by country or supported country slug.
• Filter results by optional topic.
• Filter results by optional content tag.
• Control the number of returned tweets with count.
• Get structured tweet data, including tweet text, author data, timestamps, language, hashtags, media, URLs, and engagement metrics.
• Export results through Apify datasets, webhooks, integrations, or API clients.
• Suitable for scheduled monitoring and repeatable trend tracking workflows.

Common Use Cases

• Social media trend monitoring
• Viral content discovery
• News and event tracking
• Market and audience research
• Competitor and industry monitoring
• Content ideation for newsletters, blogs, short videos, and social posts
• AI workflows that need fresh Twitter/X context
• Dashboards for regional or topic-based public attention

Input

Field	Type	Required	Description
country	string	Yes	Supported country name or slug.
topic	string	No	Optional supported topic name or slug.
tags	string	No	Optional supported content tag.
maxItems	integer	No	Maximum number of tweets to return. Minimum: 1. Maximum: 100. Default: 20.

Example input:

{
  "country": "united-states",
  "topic": "technology",
  "content": "claude",
  "maxItems": 20
}

Output

The Actor returns structured tweet records. Each result may include fields such as:

• tweet_id
• text or full_text
• created_at
• created_at_datetime
• lang
• hashtags
• cashtags
• urls
• media
• favorite_count
• retweet_count
• reply_count
• quote_count
• bookmark_count
• view_count
• user

Example output item:

{
  "tweet_id": "1803006263529541838",
  "text": "Example trending tweet text from X.",
  "created_at": "Mon Jun 17 03:51:48 +0000 2024",
  "created_at_datetime": "2024-06-17T03:51:48.000Z",
  "lang": "en",
  "hashtags": ["AI", "Tech"],
  "favorite_count": 1200,
  "retweet_count": 340,
  "reply_count": 85,
  "quote_count": 42,
  "view_count": "250000",
  "user": {
    "id": "1717001045992251392",
    "name": "Example User",
    "screen_name": "example"
  }
}

Actual output fields can vary depending on the data returned by Twitter/X for a specific request.

How to Use

1. Open the Actor on Apify.
2. Enter a supported country value.
3. Optionally add a topic or content filter.
4. Set count between 1 and 100.
5. Click Start.
6. Download the results from the dataset or connect them to your workflow.

Best Practices

• Start with count: 20 for quick checks.
• Use the maximum count: 100 for broader monitoring runs.
• Use schedules if you want recurring trend snapshots.
• Store historical datasets if you want to compare trend movement over time.
• Combine the results with sentiment analysis, keyword clustering, or AI summarization for richer insights.

Notes

• This Actor is read-only. It does not post, like, retweet, reply, or modify any Twitter/X account.
• No official X developer account is required to use the Actor.
• Results depend on Twitter/X source data availability.
• Make sure your usage complies with applicable laws, platform rules, and data protection requirements.