# 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. Unofficial. Not affiliated with or endorsed by Google. - Page: https://fous.com/methods/trends.google.com/get-interest-over-time - Method: `trends.google.com/get_interest_over_time`, version 1 - Website: trends.google.com - Returns: average interest per term, dated interest timeline, Google Trends link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `terms` | string | yes | `"coffee, tea"` | One to five search terms separated by commas, for example ChatGPT, Gemini, Claude. | | `region` | string | no | `"United Kingdom"` | Country name or US state, for example United States or California. Default: worldwide. Default "worldwide". | | `category` | string | no | `"all"` | Google Trends category name, for example Arts & Entertainment or Health. Default: all. Default "all". | | `time_range` | string | no | `"past_4_hours"` | Period to compare, for example past_12_months. 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. Its input: ```json { "terms": "coffee, tea", "region": "United Kingdom", "category": "all", "time_range": "past_4_hours" } ``` Its output: ```json { "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 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"trends.google.com/get_interest_over_time","input":{"terms":"coffee, tea","region":"United Kingdom","category":"all","time_range":"past_4_hours"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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 ## Input schema ```json { "type": "object", "required": [ "terms" ], "properties": { "terms": { "type": "string", "description": "One to five search terms separated by commas, for example ChatGPT, Gemini, Claude." }, "region": { "type": "string", "default": "worldwide", "description": "Country name or US state, for example United States or California. Default: worldwide." }, "category": { "type": "string", "default": "all", "description": "Google Trends category name, for example Arts & Entertainment or Health. Default: all." }, "time_range": { "enum": [ "past_hour", "past_4_hours", "past_day", "past_7_days", "past_30_days", "past_90_days", "past_12_months", "past_5_years", "since_2004" ], "type": "string", "default": "past_12_months", "description": "Period to compare, for example past_12_months." } } } ``` ## Output schema ```json { "type": "object", "required": [ "google_trends_link", "average_interest_by_term", "timeline" ], "properties": { "timeline": { "type": "array", "items": { "type": "object", "required": [ "date", "term", "interest" ], "properties": { "date": { "type": "string", "description": "YYYY-MM-DD, or ISO 8601 date-time for periods shorter than a week." }, "term": { "type": "string" }, "interest": { "type": "integer", "maximum": 100, "minimum": 0 } } } }, "google_trends_link": { "type": "string", "description": "Link to this comparison on Google Trends." }, "average_interest_by_term": { "type": "array", "items": { "type": "object", "required": [ "term", "average_interest", "page_link" ], "properties": { "term": { "type": "string" }, "page_link": { "type": "string" }, "average_interest": { "type": "number" } } } } } } ``` ## See more - [Google API: Get interest by region](https://fous.com/methods/trends.google.com/get-interest-by-region.md): 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. - [Google API: Get related searches](https://fous.com/methods/trends.google.com/get-related-searches.md): Returns top and rising related searches and topics for a term on Google Trends, for a country or US state and time range. - [Google API: List trending searches](https://fous.com/methods/trends.google.com/list-trending-searches.md): 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. - [Google API: List market indexes](https://fous.com/methods/google.com/list-market-indexes.md): 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 API: Get search suggestions](https://fous.com/methods/google.com/get-search-suggestions.md): Gets Google Search autocomplete suggestions for words typed so far, in Google's order, for a chosen country and language. - [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category. - [Google API: Search Google Play apps](https://fous.com/methods/play.google.com/search-apps.md): 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. - [Google API: Summarize a company's patents](https://fous.com/methods/patents.google.com/list-company-patents.md): 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. - [All Google methods](https://fous.com/methods/google.com.md)