# See a keyword's interest by US region

**Use case:** 

Break down Google Trends interest for a keyword by US state or metro: geo name, geo code and 0-100 value, with the top regions ranked.

## Input

```json
{
  "mode": "keywords",
  "searchTerms": [
    "taylor swift"
  ],
  "geo": "US",
  "timeRange": "today 12-m",
  "searchType": "web",
  "category": 0,
  "dataTypes": [
    "interestByRegion"
  ],
  "regionResolution": "REGION",
  "language": "en-US",
  "maxItems": 100,
  "monitorMode": false,
  "monitorKey": "default",
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

## Output

```json
{
  "keyword": {
    "label": "Keyword",
    "format": "text"
  },
  "geoLabel": {
    "label": "Location",
    "format": "text"
  },
  "timeRange": {
    "label": "Time range",
    "format": "text"
  },
  "property": {
    "label": "Property",
    "format": "text"
  },
  "averageInterest": {
    "label": "Avg interest",
    "format": "number"
  },
  "peakInterest": {
    "label": "Peak",
    "format": "number"
  },
  "latestInterest": {
    "label": "Latest",
    "format": "number"
  },
  "trendDirection": {
    "label": "Direction",
    "format": "text"
  },
  "topRegions": {
    "label": "Top regions",
    "format": "array"
  },
  "risingQueries": {
    "label": "Rising queries",
    "format": "array"
  },
  "trendsUrl": {
    "label": "Trends URL",
    "format": "link"
  }
}
```

## About this Actor

This example demonstrates how to use [Google Trends Scraper - Interest, Regions & Trends](https://apify.com/scrapesage/google-trends-scraper) with a specific input configuration. Visit the [Actor detail page](https://apify.com/scrapesage/google-trends-scraper) to learn more, explore other use cases, and run it yourself.