# Twitter Trends Scraper

**Use case:** 

Scrape real-time Twitter/X trending topics worldwide or by country with rank, tweet volume, hashtags, and search URLs.

## Input

```json
{
  "locations": [
    "worldwide"
  ],
  "maxTrendsPerLocation": 20,
  "getAvailableLocations": false
}
```

## Output

```json
{
  "rank": {
    "label": "Rank",
    "format": "number"
  },
  "name": {
    "label": "Trend",
    "format": "text"
  },
  "tweetVolume": {
    "label": "Tweet Volume",
    "format": "number"
  },
  "isHashtag": {
    "label": "Hashtag",
    "format": "boolean"
  },
  "locationName": {
    "label": "Location",
    "format": "text"
  },
  "countryCode": {
    "label": "Country",
    "format": "text"
  },
  "asOf": {
    "label": "As Of",
    "format": "text"
  },
  "twitterSearchUrl": {
    "label": "Search URL",
    "format": "link"
  }
}
```

## About this Actor

This example demonstrates how to use [Twitter/X Trends Scraper](https://apify.com/automation-lab/twitter-trends-scraper) with a specific input configuration. Visit the [Actor detail page](https://apify.com/automation-lab/twitter-trends-scraper) to learn more, explore other use cases, and run it yourself.