Cheap & Simple Twitter Trends API – Apify Actor

A robust, affordable, pay-per-use Apify actor that fetches real-time Twitter (X.com) trends for various locations worldwide. Results are automatically stored in your default Apify dataset for easy integration and analysis.

---

🚀 Features

• Location Dropdown: Select from over 60 countries and global regions via a simple dropdown menu.
• Pay-per-use: Efficient and cost-effective data retrieval.
• Automatic Storage: Trends are automatically saved to the Apify dataset.
• Strict Data Cleaning: Returns only relevant trend data without unnecessary metadata noise.
• Production-ready: Includes input validation and error handling for reliable automation.

---

🛠️ How to Use

1. Via Apify UI

1. Go to the actor page and click Run.
2. Fill in the input fields:
   • Location: Select your desired country or region from the dropdown menu (Defaults to Worldwide).
   • Count: Specify how many trends you want to retrieve (Defaults to 30).

2. Via Apify API

Send a POST request to the actor with a JSON body:

{
  "woeid": "1",
  "count": 30
}

---

📥 Input Schema

Field	Type	Description
woeid	string (Select)	The WOEID of the location (e.g., "1" for Worldwide).
count	integer	Number of trends to fetch (Max recommended: 50).

---

📤 Output Schema

The actor saves an array of trend objects to the dataset:

[
  {
    "trend": {
      "name": "#TwitterTrends",
      "url": "http://twitter.com/search?q=%23TwitterTrends",
      "promoted_content": null,
      "query": "%23TwitterTrends",
      "tweet_volume": 12500
    }
  },
  ...
]

---

🙋 Support

• For questions or issues, use the Apify actor page Issues tab.
• This actor is maintained to ensure compatibility with the latest Twitter/X API structures.