X Twitter Trends by Location Scraper

What is X Trends by Location Scraper?

X Trends by Location Scraper returns trending topics on X (Twitter) for the cities, countries or worldwide lists you name, as one row per trend: location, location type, country, position, trend name, hashtag and cashtag flags, snapshot time and a ready X search link. Type places in plain words such as London, Tokyo or United States. Trend lists come from public trend tracking by GetDayTrends. Local marketers, newsrooms, researchers and AI agents use it to see what a specific city or country is talking about, with no X account.

Why local teams use it

• City-level trends. Ask for London, New York or Mumbai, not only whole countries.
• Plain place names. Type locations as you would say them; country and country code are filled in.
• Ranked lists. position from 1 down for every place.
• Hashtags and cashtags flagged. Filter by isHashtag or isCashtag.
• Pay per trend. One charge per trend row.

How to use it

Trends in three cities:

{
  "locations": ["London", "Tokyo", "New York"],
  "maxTrendsPerLocation": 10
}

Worldwide and two countries, top 20:

{
  "locations": ["Worldwide", "United States", "United Kingdom"],
  "maxTrendsPerLocation": 20
}

Input	What it controls
locations	City names, country names or Worldwide
maxTrendsPerLocation	Trends per place (default 10)
dedupeTrends	Save a trend once when it appears in several places (default on)

Want the 8-hour rank history for country trends? Continue with X Twitter Trends Scraper linked below.

Output: trend data you receive

A real London row:

{
  "locationName": "London",
  "locationType": "city",
  "locationCountry": "United Kingdom",
  "locationCountryCode": "GB",
  "position": 1,
  "trendName": "#CelebrityTraitors",
  "trendType": "hashtag",
  "isHashtag": true,
  "isCashtag": false,
  "xSearchUrl": "https://x.com/search?q=%23CelebrityTraitors&src=trend_click",
  "sourceUrl": "https://getdaytrends.com/united-kingdom/",
  "dataSource": "getdaytrends",
  "snapshotAt": "2026-10-02T08:07:22.162Z"
}

Field	What it contains
locationName, locationType, locationCountry, locationCountryCode	The place: city, country or worldwide
position, snapshotAt	Rank and when the list was taken
trendName, trendType, isHashtag, isCashtag	The trend and its type
tweetVolume	Volume when the tracker publishes it
xSearchUrl, sourceUrl, dataSource	Links to the conversation and the tracker

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

Example workflow: city campaigns that ride local trends

A retail brand runs social campaigns in five cities. Every morning a task pulls the top 10 for each city, and the social team picks trends that fit the brand voice for that market. Then they check the same topics' 8-hour momentum at country level with X Twitter Trends Scraper.

Pricing

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

• 5 cities × 10 trends = 50 trend events + platform usage.
• maxTrendsPerLocation caps each place, 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's trending on X in Toronto and Vancouver right now?

Agent checklist:

1. Put place names in locations.
2. Keep maxTrendsPerLocation small for quick answers.
3. Read rows with get-dataset-items; group by locationName.
4. Share xSearchUrl for each trend.

API example

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

Related X tools from the same developer

Your next step	Use	Why
When you want rank history by country	X Twitter Trends Scraper	Country trends with 8-hour history
When you then read the posts	X Tweet Scraper	Tweets by keyword or hashtag
When you check search interest	Google Trends Scraper	Interest over time and related queries

Best results

Starting situation	Helpful action	Expected outcome
Local marketing	List the cities you operate in	Trends per city side by side
A daily brief	Schedule a morning task	A fresh snapshot every day
One trend list per place	Turn off dedupeTrends	Shared trends kept in every place
Quick checks	Lower maxTrendsPerLocation	Just the top trends

Builder's note

I found that people think in cities, not location IDs, so the Actor takes plain place names and fills in the country for you. I learned that the same trend often tops several cities, so duplicates are saved once by default.

FAQ

Do I need an X account or API key?

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

Which places are available?

Worldwide, many countries and major cities tracked by GetDayTrends, such as London, New York, Tokyo, Mumbai and Toronto.

Where do the trends come from?

From GetDayTrends, which tracks X trends for countries and cities.

Why is tweetVolume empty on some trends?

Volume is published for some trends and not others.

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.