🐦 Twitter Trends Scraper

This actor allows you to fetch trending topics for a specific country on Twitter. It uses the latest Twitter API interface to collect up to the number of trends you specify.

Features

• Fetches trending topics for any country on Twitter.
• Allows you to specify the maximum number of results (maxResults).
• Returns detailed information for each trending topic.

Supported Countries

You can select from the following countries:

• UnitedStates
• China
• India
• Japan
• Russia
• Germany
• Indonesia
• Brazil
• France
• UnitedKingdom
• Turkey
• Italy
• Mexico
• SouthKorea
• Canada
• Spain
• SaudiArabia
• Egypt
• Australia
• Poland
• Iran
• Pakistan
• Vietnam
• Nigeria
• Bangladesh
• Netherlands
• Argentina
• Philippines
• Malaysia
• Columbia
• UnitedArabEmirates
• Romania
• Belgium
• Switzerland
• Singapore
• Sweden
• Norway
• Austria
• Kazakhstan
• Algeria
• Chile
• Czechia
• Peru
• Iraq
• Israel
• Ukraine
• Denmark
• Portugal
• Hungary
• Greece
• Finland
• NewZealand
• Bulgaria
• Belarus
• Slovakia
• Serbia
• Lithuania
• Luxembourg
• Estonia

Input

• country (string, required): The country for which you want to fetch trends. Must be one of the supported countries above.
• maxResults (integer, optional): Maximum number of trends to fetch. Default is 30.

Output

The output is an array of trend objects, each containing:

• name
• description
• context

Example Input

{
  "country": "1",
  "maxResults": 50
}

Example Output

[
	{
		"name": "Hawaii",
		"description": "37.3K posts",
		"context": "Travel · Trending",
		"scrapedAt": "2025-05-30T01:45:46.981Z"
	},
	...
]

Notes

• The actor will return up to the specified maxResults number of trends.
• Country code '1' represents worldwide trends.