X Twitter Trends Scraper - Country Trends API

What is X Twitter Trends Scraper?

X Twitter Trends Scraper returns the current trending topics on X (Twitter) for worldwide and for the countries you choose, as one row per trend: position, trend name, keyword, type (hashtag, cashtag or phrase), hourly snapshot time, an 8-hour rank history and a ready X search link. Trend lists come from public trend tracking by GetDayTrends. Social media managers, newsrooms, marketers, researchers and AI agents use it to spot what's trending and react fast, with no X account or API key.

Why social teams use it

• What's trending, by country. Worldwide plus any country you track, such as the United States or the United Kingdom.
• Ranked lists. position from 1 down, with hourly snapshotAt time.
• Momentum at a glance. rankHistoryPoints and rankHistoryLabel show how a trend moved over the last 8 hours.
• Hashtags and cashtags flagged. trendType, isHashtag and isCashtag for quick filtering.
• One click to the conversation. xSearchUrl opens the trend on X.

How to use it

Worldwide and US trends:

{
  "locations": ["worldwide", "united-states"],
  "maxTrendsPerLocation": 50
}

Top 20 in three markets:

{
  "locations": ["united-kingdom", "india", "japan"],
  "maxTrendsPerLocation": 20,
  "includeRankHistory": true
}

Input	What it controls
locations	worldwide and country slugs such as united-states, united-kingdom, india, japan. Required.
maxTrendsPerLocation	Trends per location (default 50)
dedupeTrends	One row per trend per location (default on)
includeRankHistory	Add the 8-hour rank history (default on)

Want trends for specific cities? Continue with X Trends by Location Scraper linked below.

Output: trend data you receive

A real worldwide row:

{
  "locationName": "Worldwide",
  "locationSlug": "worldwide",
  "snapshotAt": "2026-10-01T19:00:00.000Z",
  "position": 1,
  "trendName": "#SchiaparellixKENGNAMPING",
  "trendKeyword": "SchiaparellixKENGNAMPING",
  "trendType": "hashtag",
  "isHashtag": true,
  "isCashtag": false,
  "rankHistoryLabel": "#SchiaparellixKENGNAMPING: trending position over last 8 hours",
  "rankHistoryPoints": "80,50 100,0 120,1 140,1",
  "trendUrl": "https://getdaytrends.com/trend/%23SchiaparellixKENGNAMPING/",
  "xSearchUrl": "https://x.com/search?q=%23SchiaparellixKENGNAMPING&src=trend_click&vertical=trends",
  "source": "getdaytrends",
  "scrapedAt": "2026-10-01T19:03:01.832Z"
}

Field	What it contains
locationName, locationSlug, locationWoeid	Where the trend is trending
position, snapshotAt, snapshotHourUtc	Rank and the hourly snapshot it belongs to
trendName, trendKeyword, trendType, isHashtag, isCashtag	The trend and its type
rankHistoryLabel, rankHistoryPoints	Rank over the last 8 hours, with includeRankHistory
tweetVolume, dailyTweetScore	Volume figures when the tracker publishes them
xSearchUrl, trendUrl, source	Links to the conversation and the tracker page

OUTPUT in the default key-value store reports the run outcome and trends saved.

Example workflow: hourly trend alerts for a newsroom

A digital newsroom watches the US and UK trend lists. A task runs every hour, and an integration posts new top-10 trends to the team's chat with xSearchUrl. Editors check rankHistoryPoints to see if a trend is climbing before assigning a story. Then they check longer-term search interest for the same topic with Google Trends Scraper.

Pricing

This Actor uses Pay per event. Apify platform usage is included in the event price. You pay one event per trend row, plus a start event per run. The live Pricing tab on this page shows the current price.

• 2 locations × 50 trends = 100 trend events.
• maxTrendsPerLocation caps each location, so it doubles as a cost ceiling.

Trend research with AI agents (MCP)

Connect this Actor to an AI agent through Apify MCP and ask in plain language:

What are the top 10 trends on X in the United Kingdom right now, and which ones are rising?

Agent checklist:

1. Put places in locations, such as worldwide or united-kingdom.
2. Keep maxTrendsPerLocation small for quick answers.
3. Read rows with get-dataset-items; sort by position.
4. Share xSearchUrl so the user can open each trend.

API example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~x-twitter-trends-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locations": ["worldwide"], "maxTrendsPerLocation": 20}'

Related trend tools from the same developer

Your next step	Use	Why
When you track city-level trends	X Trends by Location Scraper	Trends for cities and regions
When you then check search interest	Google Trends Scraper	Interest over time and related queries
When you read the posts behind a trend	X Tweet Scraper	Tweets by keyword or hashtag

Best results

Starting situation	Helpful action	Expected outcome
Real-time monitoring	Schedule an hourly task	A trend snapshot every hour
Several markets	Add each country to locations	Side-by-side trend lists
Spotting momentum	Keep includeRankHistory on	Rank movement over 8 hours
Short lists	Lower maxTrendsPerLocation	Just the top trends

Builder's note

I found that a trend's position matters less than whether it is climbing, so each row keeps the last 8 hours of rank history. I learned that people want to jump straight into the conversation, so every trend comes with a ready X search link.

FAQ

Do I need an X account or API key?

No. The Actor reads public trend tracking and needs no login.

Where do the trends come from?

From GetDayTrends, which tracks X trends hourly for worldwide and many countries.

Why is tweetVolume empty on some trends?

Volume is published for some trends and not others.

Which locations are available?

Worldwide and the countries tracked by GetDayTrends, such as the United States, United Kingdom, India, Japan, Brazil and many more.

How often do trends update?

The source updates hourly, so an hourly schedule captures every snapshot.

Responsible use

This Actor collects public trend lists. Use them for research and monitoring and follow the source's terms. Read Apify's guide on whether web scraping is legal for more context. X and Twitter are trademarks of X Corp. This independent Actor is not affiliated with, associated with, or endorsed by X Corp or GetDayTrends. For questions or bugs, open a ticket in the Issues tab.