# Google API: Get interest by region

> 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.

Unofficial. Not affiliated with or endorsed by Google.

- Page: https://fous.com/methods/trends.google.com/get-interest-by-region
- Method: `trends.google.com/get_interest_by_region`, version 1
- Website: trends.google.com
- Returns: regions ranked by interest (name, code, score, link), 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 |
|---|---|---|---|---|
| `term` | string | yes | `"pickleball"` | Search term to compare across places, for example pickleball. |
| `country` | string | no | `"United States"` | Country name or two-letter code, such as United States or US; use worldwide to list countries. Default "worldwide". |
| `time_range` | string | no | `"past_30_days"` | Period to measure, for example past_12_months. One of "past_7_days", "past_30_days", "past_90_days", "past_12_months", "past_5_years". Default "past_12_months". |
| `include_low_volume` | boolean | no | `false` | Include locations without enough measured searches as zero-interest entries; for example false. Default false. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "term": "pickleball",
  "country": "United States",
  "time_range": "past_30_days",
  "include_low_volume": false
}
```

Its output:

```json
{
  "regions": [
    {
      "link": "https://trends.google.com/trends/explore?date=today+1-m&q=pickleball&geo=US-HI",
      "interest": 100,
      "region_code": "US-HI",
      "region_name": "Hawaii"
    },
    {
      "link": "https://trends.google.com/trends/explore?date=today+1-m&q=pickleball&geo=US-UT",
      "interest": 86,
      "region_code": "US-UT",
      "region_name": "Utah"
    },
    {
      "link": "https://trends.google.com/trends/explore?date=today+1-m&q=pickleball&geo=US-NV",
      "interest": 81,
      "region_code": "US-NV",
      "region_name": "Nevada"
    }
  ],
  "google_trends_link": "https://trends.google.com/trends/explore?date=today+1-m&q=pickleball&geo=US"
}
```

## 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_by_region","input":{"term":"pickleball","country":"United States","time_range":"past_30_days","include_low_volume":false}}'
```

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

- Which countries search for pickleball the most over the past 12 months?
- Show me the regions in Germany where the term sourdough has the highest search interest in the last 90 days.
- Rank US states by interest in standing desks for the past_5_years period on Google Trends.
- Where in Canada is interest in kombucha highest over the past 30 days, including low-volume locations?
- On google.com, compare worldwide interest in electric scooters by country for the last 7 days.

## Input schema

```json
{
  "type": "object",
  "required": [
    "term"
  ],
  "properties": {
    "term": {
      "type": "string",
      "minLength": 1,
      "description": "Search term to compare across places, for example pickleball."
    },
    "country": {
      "type": "string",
      "default": "worldwide",
      "description": "Country name or two-letter code, such as United States or US; use worldwide to list countries."
    },
    "time_range": {
      "enum": [
        "past_7_days",
        "past_30_days",
        "past_90_days",
        "past_12_months",
        "past_5_years"
      ],
      "type": "string",
      "default": "past_12_months",
      "description": "Period to measure, for example past_12_months."
    },
    "include_low_volume": {
      "type": "boolean",
      "default": false,
      "description": "Include locations without enough measured searches as zero-interest entries; for example false."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "google_trends_link",
    "regions"
  ],
  "properties": {
    "regions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "region_name",
          "interest",
          "region_code",
          "link"
        ],
        "properties": {
          "link": {
            "type": "string",
            "description": "Google Trends page for the term in this place."
          },
          "interest": {
            "type": "integer",
            "maximum": 100,
            "minimum": 0
          },
          "region_code": {
            "type": "string",
            "x-fous-developer": true
          },
          "region_name": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "description": "Places ranked by relative search interest, highest first."
    },
    "google_trends_link": {
      "type": "string",
      "description": "Google Trends page for this term, country, and period."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Google API: Get interest over time](https://fous.com/methods/trends.google.com/get-interest-over-time.md): 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.
- [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: Get place reviews](https://fous.com/methods/google.com/get-place-reviews.md): Finds a place on Google Maps by name and location and returns its public reviews in the chosen order.
- [All Google methods](https://fous.com/methods/google.com.md)