Google Trends: Trending & Search Terms

An Apify Actor that fetches realtime trending searches and analyzes custom search terms from Google Trends. This actor provides two main functionalities:

1. Realtime Trending Searches: Get currently trending searches with volume data and growth metrics
2. Custom Search Terms Analysis: Analyze interest over time for any search terms

🌟 Features

• Multiple Modes: Switch between daily trends, realtime trends, or custom term analysis
• Global Coverage: Supports any country/language combination available in Google Trends
• Rich Metadata: Includes volume data, growth percentages, and trend timestamps
• Easy Integration: Simple JSON API output for easy integration with other tools
• Run Anywhere: Deploy to Apify or run locally with Docker

🚀 Quick Start

Run on Apify

1. Open the actor on Apify
2. Choose your mode (daily, realtime, or custom terms)
3. Click "Start" and get your JSON results

Run Locally

1. Install dependencies:

   $pip install -r requirements.txt
   

2. Install Apify CLI (requires Node.js >= 16):

   $npm install -g apify-cli
   

3. Run the actor:

   $apify run
   

⚙️ Input Parameters

Parameter	Type	Required	Default	Description
mode	string	No	daily	Operation mode: daily, realtime, or custom
geo	string	No	US	ISO 2-letter country code (e.g., US, GB, DE)
hl	string	No	en-US	Language code (e.g., en-US, es-ES, de-DE)
hours	number	No	24	Hours to look back for realtime trends (1-24)
terms	string	Yes*	null	Comma-separated search terms (required for custom mode)

*Required only for custom mode

📋 Example Inputs

Get Daily Trends (Default)

{
  "mode": "daily",
  "geo": "US",
  "hl": "en-US"
}

Get Realtime Trends

{
  "mode": "realtime",
  "geo": "GB",
  "hl": "en-GB",
  "hours": 12
}

Analyze Custom Terms

{
  "mode": "custom",
  "terms": "apify,scraping,automation",
  "geo": "US",
  "hl": "en-US"
}

📤 Output Format

Daily/Realtime Trends

[
  {
    "rank": 1,
    "query": "example trending search",
    "volume": 500000,
    "volume_growth_pct": 1200,
    "started": "2023-07-10T10:30:00Z",
    "geo": "US",
    "hours_since_started": 3,
    "news": 5
  }
]

Custom Terms Analysis

{
  "terms": ["apify", "scraping", "automation"],
  "geo": "US",
  "timeframe": "today 12-m",
  "averages": {
    "apify": 42,
    "scraping": 78,
    "automation": 65
  },
  "max_values": {
    "apify": 100,
    "scraping": 100,
    "automation": 89
  },
  "latest_values": {
    "apify": 45,
    "scraping": 82,
    "automation": 70
  },
  "change_pct": {
    "apify": 7.14,
    "scraping": 5.13,
    "automation": 8.33
  }
}

🔧 Development

Run with Docker

docker build -t google-trends-scraper .
docker run -it --rm -e APIFY_INPUT='{"mode":"realtime"}' google-trends-scraper

Deploy to Apify

$apify push

⚠️ Rate Limiting

Google may limit requests if you make too many in a short period. For production use, consider:

• Adding delays between requests
• Using proxy rotation
• Caching results when possible

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

4. Inspect results in the storage/datasets/default directory or in the console output.

Files

• trending_daily.py – standalone scraper logic (async, zero-dependency apart from HTTPX & BeautifulSoup).
• main.py – Apify actor entrypoint that calls the scraper and stores results.
• .actor/actor.json – Actor metadata so the Apify CLI knows how to run & build the project.
• Dockerfile – Container definition used by Apify when deploying the actor.
• requirements.txt – Python dependencies (Apify SDK + scraper deps).

Enjoy!