Global Trending Scraper

Collect tweet timelines from X global trending feeds for a selected country and optional category.

These trends come from the newer X global trending surface: https://x.com/i/jf/global-trending/home

About SIMO IT

SIMO IT builds practical social data products that support fast insight loops for marketing, PR, research, and trend monitoring teams. We focus on reliable data collection, practical automations, and production-ready scraping workflows for teams that need signal, not dashboard theater.

Features

• choose a country from a ready-made selector
• optionally switch to any supported global category such as news, sports, technology, business_and_finance, or gaming
• paginate through the global trending timeline
• push only tweet records from the backend data[] envelope to the dataset

Use cases

• monitor what is trending in one selected country
• compare category-specific trend feeds across markets
• collect fresh social content for reporting and alerting
• feed dashboards, LLM workflows, and research pipelines with current trend posts

How to use

1. Choose Country.
2. Choose Category.
3. Set pagination if you want more than one page.
4. Run the Actor.

The Actor uses the managed twitter-scrapper backend and does not require manual timeline tokens.

Need a custom plan, custom limits, or a tailored data workflow? Contact contact@simoit.tech.

If you want the older preset Explore-tab trend feeds instead, use: https://apify.com/simoit/x-twitter-preset-trends-scrapper

Related Actors

• Need the older Explore-tab preset feeds instead of country/category global trends? Use Trends Scraper.
• Need tweet search after spotting a trend in one market? Use Tweet Scraper.
• Need to inspect a specific account posting in a trend? Use Profile Scraper.
• Need profile metadata or follower graphs for accounts discovered in the feed? Use User Scraper.

Input

• country (string, required): Country market for the global trending timeline.
• category (string, optional, default all): Category selector. Supported values: all, anime, beauty, business_and_finance, cars, celebrity, cryptocurrency, dance, fashion, food, gaming, health_and_fitness, home_and_garden, memes, movies, music, nature_and_outdoors, news, pets, relationships, religion, science, sports, technology, travel.
• page (integer, optional, default 1): Starting page.
• limit (integer, optional, default 20): Items per page.
• maxPages (integer, optional, default 1): Maximum pages to fetch.
• maxItems (integer, optional): Hard cap for pushed tweets.

Output

A stream of current tweets from the selected global-trending feed, ready for monitoring, analysis, and downstream automation.

Note: backend endpoint returns an envelope: { data: [...], page, limit, has_next, country, category }. This Actor pushes only tweet objects from data[] to the dataset.

The run also stores:

• RUN_REPORT
• USER_ERROR_REPORT when input or backend validation fails

Example input

{
  "country": "united_states",
  "category": "all",
  "limit": 20,
  "maxItems": 50
}

{
  "country": "egypt",
  "category": "news",
  "limit": 10,
  "maxPages": 2,
  "maxItems": 20
}

Example output

{
  "id": 2040644451513598220,
  "id_str": "2040644451513598220",
  "url": "https://x.com/WhiteHouse/status/2040644451513598220",
  "date": "2026-04-05T04:15:25+00:00",
  "user": {
    "id": 1879644163769335808,
    "id_str": "1879644163769335808",
    "url": "https://x.com/WhiteHouse",
    "username": "WhiteHouse",
    "displayname": "The White House",
    "verified": false
  },
  "lang": "en",
  "rawContent": "We got him! ...",
  "replyCount": 10711,
  "retweetCount": 40062,
  "likeCount": 212756,
  "quoteCount": 4208,
  "conversationId": 2040644451513598220,
  "conversationIdStr": "2040644451513598220",
  "hashtags": [],
  "cashtags": [],
  "mentionedUsers": [],
  "links": [],
  "media": {
    "photos": [{ "url": "https://pbs.twimg.com/media/HFHTUDYaMAABWvk.jpg" }],
    "videos": [],
    "animated": []
  },
  "viewCount": 9903563,
  "_type": "snscrape.modules.twitter.Tweet"
}

Returned fields

• id, id_str: tweet identifier
• url: direct X post URL
• date: post timestamp
• user: embedded author object with account metadata
• rawContent: main tweet text
• replyCount, retweetCount, likeCount, quoteCount: engagement counters
• conversationId, conversationIdStr: conversation identifier
• hashtags, cashtags, mentionedUsers, links: extracted entities
• media: grouped photos, videos, and animated media
• viewCount: post view count when available
• _type: parser output type from the backend

FAQ

Do I need my own backend or API setup?
No. This Actor is ready to run on Apify, and backend infrastructure is managed by SIMO IT.

Where do these trends come from?
From the newer X global-trending surface at https://x.com/i/jf/global-trending/home.

Can I choose both country and category?
Yes. Country is required, and category is optional. Use all for the default feed.

What if I want the older Explore-tab presets instead?
Use https://apify.com/simoit/x-twitter-preset-trends-scrapper.

Can I collect more than one page?
Yes. Increase maxPages and tune limit and maxItems to fetch more results.