Twitter Trends Scraper

Scrape real-time X (Twitter) trending topics by country, city, or worldwide — with optional historical windows (1h to 7d), batch multi-location mode, and category-aware output. HTTP-only via getdaytrends.com, no login, no API key. MCP-ready for AI agents.

Returns the public trends board that X shows on its "What's happening" page. Does not require Twitter login, developer account, or any API key.

---

What you get

• Real-time Top 50 trends for Worldwide + 138 supported locations (countries + major cities).
• Historical snapshots at 1h, 2h, 3h, 6h, 12h, 24h, 2d, 3d, 7d, or a custom UTC datetime.
• Multi-location batch in a single run — useful for cross-market comparisons.
• Compact sparkline history — last 8 hours of rank trajectory per trend, when available.
• Deduplication mode — collapse repeats across locations into one row with locations[].
• Direct x.com/search URLs for each trend — ready for downstream content workflows.

Each dataset row is one trend at one rank, one location, one time window. Records are flat and agent-friendly.

---

Sample output

{
  "recordType": "trend",
  "rank": 1,
  "name": "Dodgers",
  "hashtag": false,
  "url": "https://getdaytrends.com/united-states/trend/Dodgers/",
  "searchUrl": "https://x.com/search?q=Dodgers",
  "volume": null,
  "volumeLabel": null,
  "category": null,
  "promoted": false,
  "location": "United States",
  "locationSlug": "united-states",
  "woeid": 23424977,
  "windowLabel": "Now",
  "windowHoursBack": 0,
  "windowTimestamp": null,
  "history": [
    { "t": "2026-08-02T15:00:00.000Z", "rank": 1 },
    { "t": "2026-08-02T14:00:00.000Z", "rank": 1 }
  ],
  "source": "getdaytrends",
  "scrapedAt": "2026-08-02T16:12:34.000Z"
}

---

Input

Field	Type	Default	Description
locations	string[]	["worldwide"]	Slugs (united-states), display names (Brazil), full URLs, or WOEIDs (23424977).
window	enum	now	now, 1h, 2h, 3h, 6h, 12h, 24h, 2d, 3d, 7d, custom.
customDateTime	string	—	UTC YYYY-MM-DD HH (used only when window=custom).
maxTrendsPerLocation	integer	50	Cap per location/window.
hashtagOnly	boolean	false	Only return #hashtag trends.
deduplicateAcrossLocations	boolean	false	Collapse repeats into one row with locations[].
includeHistory	boolean	true	Attach history[] sparkline samples.
listAvailableLocations	boolean	false	Return the supported-locations catalog instead of trends.

---

Pricing — Pay per event + usage

Event	Price
Actor start	$0.00005
Trend scraped	$0.0005

Typical run (Worldwide, Now, 50 trends): 1 × $0.00005 + 50 × $0.0005 = ~$0.025 + Apify platform usage.

Multi-location batch (5 locations × 50 trends): 1 × $0.00005 + 250 × $0.0005 = ~$0.125 + usage.

Platform usage (compute + proxy) is billed through via isPPEPlatformUsagePaidByUser: true. getdaytrends is HTTP-only and rarely WAF-protected, so residential proxy usage is minimal in practice.

---

Use cases

• Social-listening dashboards — pump Worldwide + top 10 markets into a monitoring stack every 15 minutes.
• Newsrooms — surface breaking trends before they hit the wire.
• Creator/content teams — match trends to existing editorial calendars via the searchUrl.
• Market researchers — compare the same time window across LATAM, EU, and APAC.
• AI agents — clean, narrow JSON, one verb ("get trends"), under 500 tokens per item.

---

How it works

1. Builds a getdaytrends.com/{slug}/{window}/ URL per requested location.
2. Fetches server-rendered HTML with HttpCrawler (Cheerio-style regex parsing — no headless browser needed).
3. Extracts rank, name, URL, and the inline sparkline <polyline points> for trajectory.
4. Charges per dataset row pushed.
5. Writes OUTPUT and RUN_SUMMARY to the key-value store with COMPLETE, PARTIAL, VALID_EMPTY, INVALID_INPUT, or UPSTREAM_FAILED outcome.

No X login. No Twitter developer account. No third-party API key required.

---

MCP / Agent usage

Tool description (what an LLM sees):

Scrape real-time X (Twitter) trending topics by country, city, or worldwide — with optional historical windows (1h to 7d). Use for social monitoring, news tracking, content planning. Returns trend name, rank, hashtag flag, search URL, and optional sparkline history. Charged $0.0005/trend + $0.00005 start.

Agent-friendly example:

{
  "locations": ["worldwide", "united-states", "japan"],
  "window": "now",
  "maxTrendsPerLocation": 20,
  "includeHistory": false
}

Returns 60 rows (~$0.03 + usage). Agent can confidently predict cost from maxTrendsPerLocation × len(locations).

---

API example

curl -XPOST -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  "https://api.apify.com/v2/acts/khadinakbar.twitter-trends-scraper/runs?token=$APIFY_TOKEN" \
  -d '{"locations":["worldwide"],"window":"now","maxTrendsPerLocation":50}'

Results: https://api.apify.com/v2/datasets/{DATASET_ID}/items

---

Available locations

138 supported. Set listAvailableLocations: true to dump the full catalog (slug, displayName, country, countryCode, woeid) as dataset rows. Highlights: Worldwide (1), United States (23424977), United Kingdom (23424775), Japan (23424856), Brazil (23424762), India (23424848), Germany (23424829), France (23424819), plus 130 country/city entries.

---

Legal disclaimer

This actor scrapes publicly available trend data from a third-party aggregator (getdaytrends.com) that mirrors the public X (Twitter) trends board. It does not access private accounts, authenticated endpoints, or login-protected content. Trend names and rankings are public. Users are responsible for complying with the terms of service of X (Twitter), getdaytrends.com, and applicable laws in their jurisdiction. The actor is provided for research, journalism, marketing intelligence, and similar legitimate purposes.