Skip to content

Google API: Get interest over time

Compares Google Trends search interest for one to five terms over a time range, with average scores and a dated timeline. Scores are relative within the comparison.

trends.google.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Google.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Terms, requiredterms

One to five search terms separated by commas, for example ChatGPT, Gemini, Claude.

coffee, tea

Region optionalregion

Country name or US state, for example United States or California. Default: worldwide.

United Kingdom

Default worldwide.

Category optionalcategory

Google Trends category name, for example Arts & Entertainment or Health. Default: all.

all

Default all.

Time Range optionaltime_range

Period to compare, for example past_12_months.

past_4_hours

One of past_hour, past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years, since_2004. Default past_12_months.

Output

From a run on Oct 23, 2026, shortened for this page.
{  "timeline": [    {      "date": "2026-10-23T04:14:00+00:00",      "term": "coffee",      "interest": 0    },    {      "date": "2026-10-23T04:14:00+00:00",      "term": "tea",      "interest": 0    },    {      "date": "2026-10-23T04:15:00+00:00",      "term": "coffee",      "interest": 0    }  ],  "google_trends_link": "https://trends.google.com/trends/explore?q=coffee%2Ctea&date=now+4-H&geo=GB",  "average_interest_by_term": [    {      "term": "coffee",      "page_link": "https://trends.google.com/trends/explore?q=coffee%2Ctea&date=now+4-H&geo=GB",      "average_interest": 50    },    {      "term": "tea",      "page_link": "https://trends.google.com/trends/explore?q=coffee%2Ctea&date=now+4-H&geo=GB",      "average_interest": 18    }  ]}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
trends.google.com/get_interest_over_time
Returns
average interest per term, dated interest timeline, Google Trends link

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method trends.google.com/get_interest_over_time with the inputs above.

Ask your agent

  • How has search interest for ChatGPT, Gemini, and Claude changed over the past 12 months?
  • Compare Google Trends interest for electric vehicles versus hybrid cars in California over the last 5 years
  • Show me a dated timeline of how often people searched for yoga in the United States during the past 90 days
  • What's the average relative search popularity of Bitcoin and Ethereum worldwide since 2004?
  • Google Trends data for ski resorts, Health category, past 30 days, average interest per term
  • Shows where a search term has the highest relative Google Trends interest, by country worldwide or by region within a country. Scores run from 0 to 100.

    trends.google.com/get_interest_by_region
  • Returns top and rising related searches and topics for a term on Google Trends, for a country or US state and time range.

    trends.google.com/get_related_searches
  • Lists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines.

    trends.google.com/list_trending_searches
  • Lists major stock market indexes on Google Finance with their current levels, changes and quote times. Quotes may be delayed, and indexes Google does not show are left out.

    google.com/list_market_indexes
  • Gets Google Search autocomplete suggestions for words typed so far, in Google's order, for a chosen country and language.

    google.com/get_search_suggestions
  • Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.

    play.google.com/list_top_charts
  • Finds Android apps on Google Play by keywords, in Play search order, with each listing's developer, star rating, price and currency for the chosen country, download range and link. Results are limited to apps shown on the public search page.

    play.google.com/search_apps
  • Summarizes a company's public patents on Google Patents within filing dates (optionally narrowed by topic words): total found, filings per year, top technology areas and inventors across the 50 most recent records, and the most recent patents.

    patents.google.com/list_company_patents