Google Trends Scraper

Get interest over time, interest by region, related queries and related topics from Google Trends — with session rotation, retries, and honest handling of Google’s scraper limitations.

Compare up to 5 terms on one chart or run many terms one by one.

---

🚀 Why this Actor

• Retries that recover — exponential backoff + session/IP rotation on 429/403/5xx
• Honest about Google limits — reports googleUserType and moves suspected “Breakout” decoys into suspectedDecoys
• Failures are visible — failed queries still produce a row with status: "failed"
• One clean row per query with every section keyed by search term
• Supports Web, YouTube, News, Images, Shopping

---

📥 Input

Field	Default	Description
searchTerms	required	Keywords / topics
mode	separate	separate or compare (max 5 terms)
geo	"" (worldwide)	e.g. US, GB, US-CA
timeframe	today 12-m	now 1-H … today 5-y, all, or custom range
category	0	Google Trends category ID
property	web	web / youtube / news / images / shopping
outputs	interestOverTime, interestByRegion, relatedQueries	relatedTopics is opt-in
risingFilter	strict	Moves suspected decoys aside
regionResolution	AUTO	COUNTRY / REGION / DMA / CITY
proxyConfiguration	Apify Proxy	Recommended

Example input

{
  "searchTerms": ["web scraping"],
  "mode": "separate",
  "geo": "US",
  "timeframe": "today 12-m",
  "property": "web",
  "outputs": ["interestOverTime", "interestByRegion", "relatedQueries"],
  "proxyConfiguration": { "useApifyProxy": true }
}

---

📤 Output

One dataset item per query with:

• status (ok / failed)
• interestOverTime
• interestByRegion
• relatedQueries (top + rising + suspectedDecoys)
• relatedTopics (when available)
• googleUserType, warnings, trendsUrl, scrapedAt

---

Example output

Sample rows from a real owner run (public scrape data):

[
  {
    "status": "ok",
    "searchTerms": [
      "web scraping"
    ],
    "geo": "US",
    "timeframe": "today 12-m",
    "category": 0,
    "property": "web",
    "trendsUrl": "https://trends.google.com/trends/explore?date=today%2012-m&q=web%20scraping&geo=US&hl=en-US",
    "averages": null,
    "scrapedAt": "2026-11-06T17:03:02.452Z",
    "interestOverTime": [
      {
        "date": "2025-11-02T00:00:00.000Z",
        "timestamp": 1762041600,
        "formattedTime": "Nov 2\u2009\u2013\u20098, 2025",
        "values": {
          "web scraping": 79
        },
        "isPartial": false
      },
      {
        "date": "2025-11-09T00:00:00.000Z",
        "timestamp": 1762646400,
        "formattedTime": "Nov 9\u2009\u2013\u200915, 2025",
        "values": {
          "web scraping": 75
        },
        "isPartial": false
      },
      {
        "date": "2025-11-16T00:00:00.000Z",
        "timestamp": 1763251200,
        "formattedTime": "Nov 16\u2009\u2013\u200922, 2025",
        "values": {
          "web scraping": 76
        },
        "isPartial": false
      }
    ],
    "interestByRegion": [
      {
        "geoCode": "US-MD",
        "geoName": "Maryland",
        "values": {
          "web scraping": 100
        }
      },
      {
        "geoCode": "US-WY",
        "geoName": "Wyoming",
        "values": {
          "web scraping": 82
        }
      },
      {
        "geoCode": "US-KS",
        "geoName": "Kansas",
        "values": {
          "web scraping": 37
        }
      }
    ],
    "relatedQueries": {
      "web scraping": {
        "top": [
          {
            "query": "web data scraping",
            "value": 100,
            "formattedValue": "100",
            "link": "https://trends.google.com/trends/explore?q=web+data+scraping&date=today+12-m&geo=US"
          },
          {
            "query": "ai web scraping",
            "value": 89,
            "formattedValue": "89",
            "link": "https://trends.google.com/trends/explore?q=ai+web+scraping&date=today+12-m&geo=US"
          }
        ],
        "rising": [
          {
            "query": "best pizza near me",
            "value": 350,
            "formattedValue": "+350%",
            "link": "https://trends.google.com/trends/explore?q=best+pizza+near+me&date=today+12-m&geo=US"
          },
          {
            "query": "email marketing for restaurants",
            "value": 150,
            "formattedValue": "+150%",
            "link": "https://trends.google.com/trends/explore?q=email+marketing+for+restaurants&date=today+12-m&geo=US"
          }
        ]
      }
    }
  }
]

💰 Pricing (Pay-per-event)

Event	Price
Actor start	$0.0005 per start, charged once per GB of run memory
Dataset result	$0.0003 per query row written

Memory: the default is 512 MB, which bills a single start event.

Example: 1 search term at default memory ≈ $0.0005 + $0.0003 ≈ $0.0008. Ten terms ≈ $0.0005 + 10 × $0.0003 ≈ $0.0035.

---

⚙️ Memory limits

• Min: 512 MB
• Max: 2048 MB

---

📝 Limits (as of 2026)

• Related topics are usually empty for non-logged-in sessions
• Rising queries may still contain some decoys — treat as directional
• Use Apify Proxy for large batches

This Actor only uses public, non-logged-in Google Trends data.