X (Twitter) Trends Scraper

Get real-time and historical top trending topics, hashtags, and keywords from X.com for any of 35 countries — or a combined Global feed with lighting fast speed at cheapest - 0.05 per 1000 results.

This Actor connects directly to the same internal API that X.com uses to load its Explore → Trending page. Every result you get is exactly what a real user in that country would see right now, or at any point in the last 100 hours.

---

What You Get

Each run returns up to 30 ranked trends per country snapshot, or up to 150 trends for the Global feed. Every trend record includes:

• Rank — position 1–30 in the trending list
• Trend name — the exact hashtag or topic (e.g. #GeneralConference, Walter Reed, Happy Easter)
• Category — the content type X assigns it: Sports, Music, Politics, Entertainment industry, Business and finance, Trending (general), etc.
• Context — the full domain string X shows users, e.g. "Sports · Trending" or "Trending in United States"
• Status — Live for real-time fetches, or 1 hour ago / 6 hours ago etc. for historical snapshots
• Age (hours) — how many hours ago the snapshot was recorded
• Recorded At (UTC) — exact ISO timestamp of when the data was captured

Example output record:

{
  "rank": 3,
  "trend": "Happy Easter",
  "category": "Entertainment industry",
  "domain_context": "Entertainment industry · Trending",
  "status": "Live",
  "age": 0,
  "time": "2025-04-05T10:00:00.000Z"
}

You can download the full dataset in JSON, CSV, HTML, or Excel from the Apify Console Output tab.

---

Supported Countries (35 + Global)

The Actor routes its residential proxy through the country you select, so you receive the trending topics that users in that country actually see — not a generic feed.

Region	Countries
🌍 Global	Combined feed of worldwide trends (up to 150 topics)
🇺🇸 North America	United States, Canada, Mexico
🇬🇧 Europe	United Kingdom, France, Germany, Italy, Spain, Portugal, Netherlands, Denmark, Austria, Belgium, Switzerland, Greece
🇷🇺 Eastern Europe & Middle East	Russian Federation, Turkey, Israel, United Arab Emirates, Saudi Arabia, Egypt
🌏 Asia-Pacific	Korea, Singapore, Indonesia, Philippines, Viet Nam, Thailand, Australia, Japan
🌍 Africa	Nigeria, Kenya, South Africa
🌎 Latin America	Argentina, Brazil, Mexico

How country targeting works: When you select Japan, the residential proxy routes your request through a Japanese IP address. X.com returns the trending topics it shows Japanese users — local language, regional news, and country-specific events included. Selecting Global aggregates trending data from all 34 country feeds into a single deduplicated list of up to 150 topics.

---

How to Use It

Step 1 — Configure your run

Open the Actor input form and select your options:

Input Field	What it does	Default
Country	Which country's trending feed to fetch	United States
Live	Fetch what's trending right now	On
1 hour ago	Include the stored snapshot from 1 hour ago	Off
3 hours ago	Include the stored snapshot from 3 hours ago	Off
6 hours ago	Include the stored snapshot from 6 hours ago	Off
12 hours ago	Include the stored snapshot from 12 hours ago	Off
24 hours ago	Include the stored snapshot from 24 hours ago	Off
2 days ago	Include the stored snapshot from 48 hours ago	Off
3 days ago	Include the stored snapshot from 72 hours ago	Off

You can enable multiple time periods at once. The output will contain one clearly labeled snapshot per period selected — useful for comparing what was trending now vs 6 hours ago vs yesterday.

Step 2 — Run and get results

Click Start. The Actor completes in under 30 seconds. Results appear in the Output tab immediately.

---

Input Examples

Live trends for the UK right now:

{
  "country": "United Kingdom",
  "live": true
}

Live + compare to 6 hours ago and 24 hours ago in Japan:

{
  "country": "Japan",
  "live": true,
  "hour6": true,
  "hour24": true
}

Historical only — what was trending in Brazil 3 days ago:

{
  "country": "Brazil",
  "live": false,
  "day3": true
}

Global feed — live trends + 24-hour comparison:

{
  "country": "Global",
  "live": true,
  "hour24": true
}

Use Cases

Media monitoring — Track which topics are dominating conversation in specific countries right now vs 24 hours ago. Spot emerging stories before they peak.

Marketing & PR — Identify trending hashtags and topics in your target market before launching campaigns. Join relevant conversations at the right moment.

Competitive intelligence — See which brands, events, and topics are gaining traction in markets you operate in or plan to enter.

Academic & social research — Build longitudinal datasets of trending topics across countries and time periods for analysis.

Content strategy — Discover what your audience is talking about in real time to inform what content to create and when to publish it.

Financial research — Monitor trending tickers, economic terms, and market-relevant topics across different geographies.

News & journalism — Get a country-level pulse on what the public is discussing at any given moment across 35 markets.

---

Data Accuracy

This Actor uses X.com's own internal API — the exact same endpoint that your browser calls when you open the Explore → Trending page. The data returned is bit-for-bit identical to what you would see if you opened X.com yourself while physically located in the selected country.

Geo-targeted to your selection - Global → aggregates all 34 country feeds into one deduplicated list

There is no sampling, filtering, or estimation involved. You get the full ranked list exactly as X presents it.

---

Cost

Each run makes one authenticated API call per country. A single live fetch for one country completes in under 10 seconds.

Mode	API calls	Approximate cost
Live — 1 country	1	< $0.01

Actual costs depend on your Apify plan.

---

Frequently Asked Questions

Do I need X Premium or a developer account? No. The Actor uses your regular X.com session cookies — the same ones your browser uses to keep you logged in. Any standard free or paid X account works.

How fresh is the live data? Live mode fetches data the moment you click Run. What you receive is exactly what X shows to users in the selected country at that instant.

Why might I see fewer than 30 trends? X occasionally returns fewer than 30 trends for some countries, particularly smaller markets, or during low-activity periods. The Actor returns whatever X provides without padding or estimation.

Is this legal? This Actor accesses publicly visible trending data using your own authenticated X.com session. Trending topics are publicly displayed on X.com's Explore page and visible to any logged-in user. Always use responsibly and in accordance with X's Terms of Service.

---

⚠️ X.com Changes

X.com frequently modifies its internal structure without public notice — including GraphQL endpoint IDs, feature flag parameters, response schemas, and authentication requirements.

If this Actor stops returning results or starts throwing errors, it is most likely because X.com has changed one of the following:

• The timelineId for the trending feed
• Required request headers or features parameters
• The JSON structure of the trending response

Please raise an issue

Open the Issues tab on this Actor's page and include:

1. The date you noticed the problem
2. The country you were querying
3. The error message from the Actor run log
4. A note of whether live or historical data is affected

Community reports are the fastest way to catch breaking changes. We aim to ship fixes within 24–48 hours of a confirmed X.com API change.

---

Support & Custom Integrations

For bugs or broken results — use the Issues tab on this Actor's page.

For high-volume setups, additional country coverage, custom data pipelines, or white-label integrations — reach out via the Issues tab with your requirements.