Google Trends API — fast, no browser, unlimited comparisons

Get Google Trends data for hundreds of search terms in minutes: interest over time, interest by region (countries, regions, cities, US metro areas), related queries (top and rising) and trending searches now for any country.

This Actor talks to Google Trends directly over HTTP, without launching a browser. That makes it fast, light and cheap, and it paces its requests and rotates sessions so Google's rate limits don't break your run.

Why this Actor

• Compare any number of terms on one scale. Google Trends compares at most 5 terms at a time, and every chart has its own 0-100 scale, so numbers from different charts can't be compared. In Compare mode this Actor bridges groups of 5 with a shared anchor term and puts all your terms on the same 0-100 scale.
• You pay only for results. A term that fails after all retries is returned with the reason and is not charged. No fee per run.
• Spreadsheet-ready output. Choose Rows to get one flat row per data point, ready for Excel, Google Sheets or a database. Or keep Nested to get one item per term with everything inside.
• Everything Google Trends shows: any country or region, any time range (past hour to 2004-present, or custom dates), categories, and Web, Image, News, Shopping or YouTube search.

What you can use it for

• SEO and content planning: find rising queries before they peak, pick the keyword people actually search.
• Market and product research: compare brands, products or ideas across countries and seasons.
• E-commerce: spot seasonal demand and trending products with Google Shopping data.
• Finance and data science: build time series of public interest for models and dashboards.
• AI agents: call it from your agent through the Apify API or MCP to answer "is this growing?" questions.

Modes

Mode	What you get
Keywords	One item per term, on its own 0-100 scale: interest over time, average, interest by region, related queries, link to the same chart on Google Trends.
Compare	One item per term, all terms on one shared 0-100 scale (unlimited terms), with a precision flag for each term.
Trending now	Today's trending searches for each country you list, with approximate traffic and news articles.

Input example

{
  "mode": "keywords",
  "searchTerms": ["coffee", "matcha", "cold brew"],
  "geo": "US",
  "timeRange": "today 12-m",
  "interestOverTime": true,
  "interestByRegion": true,
  "relatedQueries": true
}

Output example (Keywords mode, real run, lists shortened)

{
  "keyword": "matcha",
  "geo": "US",
  "timeRange": "today 12-m",
  "category": 0,
  "property": "",
  "language": "en-US",
  "status": "ok",
  "interestOverTime": [
    { "date": "2026-09-13T00:00:00.000Z", "value": 74, "isPartial": false },
    { "date": "2026-09-20T00:00:00.000Z", "value": 64, "isPartial": false },
    { "date": "2026-09-27T00:00:00.000Z", "value": 65, "isPartial": true }
  ],
  "averageInterest": 75.21,
  "interestByRegion": [
    { "geoCode": "US-HI", "geoName": "Hawaii", "value": 100 },
    { "geoCode": "US-WY", "geoName": "Wyoming", "value": 95 }
  ],
  "relatedQueries": {
    "top": [{ "query": "matcha latte", "value": 100, "formattedValue": "100" }],
    "rising": [{ "query": "starbucks banana bread matcha", "value": 9600, "formattedValue": "Breakout" }]
  },
  "googleTrendsUrl": "https://trends.google.com/trends/explore?date=today+12-m&q=matcha&hl=en-US&geo=US",
  "scrapedAt": "2026-09-28T15:57:45.449Z"
}

isPartial: true marks the current period, which is not over yet. averageInterest leaves it out.

Compare mode: how the shared scale works

Terms are split into groups of the anchor term plus 4 others. The anchor appears in every group, so each group can be rescaled to the first one, and at the end everything is normalized so the highest point is 100. Google rounds values to whole numbers, so a term that is very small next to the anchor loses precision: each term gets scaleConfidence = high, medium or low. For best results pick an anchor term with popularity similar to your other terms.

Tips

• Values are relative (0-100), not search volumes. This is how Google Trends works.
• Short time ranges (past hour / day) return hourly or minute data; long ones return weekly or monthly data.
• Parallel sessions (default 10) sets the speed: each session uses its own IP address and paces its requests. If Google rate-limits a session, the Actor retries on a fresh one automatically.

Is it legal?

This Actor collects publicly available, aggregated and anonymous statistics from Google Trends. It does not use any Google account and collects no personal data. Check that your use complies with Google's terms and the laws that apply to you.

Support

Found a problem or need a feature? Open an issue on the Actor's Issues tab: we answer quickly.