Twitter Trends Scraper

Scrape Twitter/X trending topics by country or worldwide. Extract trend ranks, names, position chart metadata, and Twitter search links for current trends, recent hours, or historical date/time snapshots.

Key Features

• Scrape trends for 60+ countries and worldwide
• Support current trends, N hours ago, or a specific UTC date/hour
• Extract rank, trend name, and graph title
• Batch scrape multiple countries in one run
• Optional proxy configuration

Input

Field	Type	Required	Description
countries	array	Yes	Country slugs, e.g. australia, united-states, worldwide
hoursAgo	integer	No	Trends from N hours ago (0 = now)
date	string	No	Historical date YYYY-MM-DD
hour	integer	No	UTC hour 0-23 when using date
maxItems	integer	No	Max trends per country (default: 50)
proxyConfiguration	object	No	Proxy settings

Input Example

{
    "countries": ["australia", "united-states"],
    "hoursAgo": 2,
    "maxItems": 50
}

Historical example:

{
    "countries": ["worldwide"],
    "date": "2026-05-13",
    "hour": 22,
    "maxItems": 50
}

Output

Each trend is saved as one dataset record:

{
    "country": "australia",
    "hoursAgo": 2,
    "date": null,
    "hour": null,
    "rank": 1,
    "trend": "Senegal",
    "trendSlug": "Senegal",
    "twitterSearchUrl": "https://x.com/search?q=Senegal",
    "graphTitle": "Senegal: trending position over last 8 hours",
    "scrapedAt": "2026-07-02T12:00:00.000Z"
}

Supported Countries

Worldwide, Algeria, Argentina, Australia, Austria, Bahrain, Belarus, Belgium, Brazil, Canada, Chile, Colombia, Denmark, Dominican Republic, Ecuador, Egypt, France, Germany, Ghana, Greece, Guatemala, India, Indonesia, Ireland, Israel, Italy, Japan, Jordan, Kenya, Korea, Kuwait, Latvia, Lebanon, Malaysia, Mexico, Netherlands, New Zealand, Nigeria, Norway, Oman, Pakistan, Panama, Peru, Philippines, Poland, Portugal, Puerto Rico, Qatar, Russia, Saudi Arabia, Singapore, South Africa, Spain, Sweden, Switzerland, Thailand, Turkey, Ukraine, United Arab Emirates, United Kingdom, United States, Venezuela, Vietnam

Use Cases

• Social media trend monitoring
• Regional market and news research
• Competitive intelligence
• Content planning and hashtag discovery